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PREFACE 


Primary reference for user and subsystem programming on the Multics system 
is contained in six manuals. The manuals are collectively referred to as the 
Multics Programmers! Manual (MPM). Throughout this manual references are 
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Document Referred To In Text As 
Reference Guide MPM Reference Guide 
(Order No. AG91) 


Commands and Active Functions MPM Commands 


(Order No. AG92) 


Subroutines MPM Subroutines 
(Order No. AG93) 
Subsystem Writers' Guide MPM Subsystem Writers' Guide 


Order No. AK92) 


Peripheral Input/Output MPM Peripheral I/0 
(Order No. UNG) 


Communications Input/Output MPM Communications I/0 
(Order No. CC92) 


The MPM Reference Guide contains general information about the Multics command 
and programming environments. It also defines items used throughout the rest of 
the MPM and, in addition, describes such subjects as the command language, the 
storage system, and the input/output system. 


The MPM Commands is organized into four sections. Section I contains a 
list of the Multics command repertoire, arranged functionally. Section II describes 
the active functions. Section III contains descriptions of standard Multics 
commands, including the calling sequence and usage of each command. Section IV 
describes the requests used to gain access to the system. 


The MPM Subroutines is organized into three sections. Section I contains a 
list of the subroutine repertoire, arranged functionally. Section II contains 
descriptions of the standard Multics subroutines, including the declare statement, 
the calling sequence, and usage of each. Section III contains descriptions of 
the I/O modules. 


The information and specifications in this document are 
anhiect to change without notice. Thia document. containa& 
information about Honeywell products or services that may 
not be available outside the United States. Consult your 
Honeywell Marketing Representative. 
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The MPM Subsystem Writers' Guide is a reference of interest to compiler 
writers and writers of sophisticated subsystems. It documents user-accessible 
modules that allow the user to bypass standard Multics facilities. The interfaces 
thus documented are a level deeper into the system than those required by the 
majority of users. 


The MPM Peripheral I/O manual contains descriptions of commands and subroutines 
used to perform peripheral I/O. Included in this manuai are commands and subroutines 
that manipulate tapes and disks as I/0 devices. 


The MPM Communications I/O manual contains information about the Multics 
Communication System. Included are sections on the commands, subroutines, and 
I/O modules used to manipulate communications I/0. Special purpose communications 
I/O, such as binary synchronous communication, is also included. 


Examples of specialized subsystems for which construction would require 
reference to the MPM Subsystem Writers' Guide are: 


s A subsystem that precisely imitates the command environment of some 
system other than Multics. 


a A subsystem intended to enforce restrictions on the services available 


to a set of users (e.g., an APL-only subsystem for use in an academic 
elass). 


s A subsystem that protects some kind of information in a way not easily 
expressible with ordinary access control lists (e.g., a proprietary 
linear programming system, or an administrative data base system that 
permits access only to program-defined, aggregated information such as 
averages and correlations). 


Several cross-reference facilities help locate information: 


r Each manual has a table of contents that identifies the material (either 
the name of the section and subsection or an alphabetically ordered 
list of command and subroutine names) by page number. 


s Each manual contains an index that lists items by name and page number. 


Portions of this manual give information most useful for special applications 
of the Multics Communication System. These sections are of limited interest to 
general users, and include: "Syntax of the TTF" in Section 3, the ttt info 
subroutine described in Section 5, and the I/O modules, except tty , described 
in Section 6. ~ 


One additional manual referenced is the Multics Administrators! 
Manual--Communications, Order No. CC75. It is referred to in the text as MAM 
Communications. 


Changes to MPM Communications I/0 contained in Addendum A include: new 
baud rate information in Section 3; a new command, the dial out command, in 
Section 4; a number of changes and clarifications to the tty I/0 module description 
in Section 6, including the new control arguments -dial id and -resource; and 
changes to the printer modes described in Appendix B. 7 
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SECTION 14 


OVERVIEW OF MULTICS COMMUNICATION SYSTEM 


The Multics Communication System (MCS) effects the transfer of data between 
the Muitics virtual memory and various remote devices (primarily terminals) over 
communications channels. This manual is concerned with MCS as it appears to the 
user of a terminal. For a description of the internal workings of MCS, see the 
appropriate program logic manual. 


The bulk of MCS resides in the Multics supervisor and in a separate machine, 
the Front-End Network Processor (FNP). The user-ring and supervisor portions of 
MCS are principally concerned with terminal management, while the FNP's primary 
responsibility is channel management. In general, the user need not be concerned 
with channel management. Most user and system programs interface to MCS through 
the input/output system by means of the iox_ subroutine, described in the MPM 
Subroutines. For general information on the use of the I/O system, see "Input 
and Output Facilities" in the MPM Reference Guide. 


TERMINALS AND CHANNELS 


The term "channel" (or "communications channel"), as used in this manual, 
refers to a physical connection between an FNP and a remote input/output device. 
Such a connection may go through a telephone system or a private communications 
network, or it may consist of one or more hardwired cables. For information on 
the specification and management of all communications channels known to the 
system, see the MAM Communications. 


The word "terminal" is used to refer to the device itself; it may be an 
ordinary interactive terminal on which a user types commands, or it may be a 
computer controlling one or more peripheral devices. 


ATTACHMENTS 


An interactive terminal is normally connected to the system (attached) through 
the tty 1/0 module described in Section 6. For the user's login terminal, this 
attachment is performed automatically in the course of process creation. Additional 
terminals connected to the user's process using the dial facility must be attached 
explicitly. For more information on the dial facility, see the descriptions of 
the dial command in MPM Commands and the dial_manager_ subroutine in the MPM 
Subsystem Writer's Guide. 


Other types of devices that use special communications protocols may have 
to be attached through special-purpose I/O modules. Several such modules are 
supplied with the system; they are described in Section 6. Users and sites may 
also supply their own I/O modules that interface to one of the existing modules. 
For information, see "Implementation of Input/Output Modules" in the MPM Subsystem 
Writer's Guide. 
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DATA TRANSFORMATION 


One of the most visible functions of MCS is the transformation of data read 
from or written to the terminal. This may include rearrangement of white space, 
replacement of one character by a sequence of characters, and, in some cases, 
wholesale translation from one character code to another. The types of conversion 
for input and output are described in Section 2. The specifie details of any 
particular conversion are determined by terminal type and, to a lesser extent, 
by the modes associated with the attachment. Terminal types are explained in 
Section 3, and the effects of the various modes are given in the description of 
the tty 1I/0 module. The set tty command, described in Section 4, can be used 
to change the terminal type or to modify many of the parameters used in converting 
input or output. 


The special-purpose I/O modules (those other than tty_) usually perform 
their own data conversions independent of terminal type. They generally put the 
terminal in rawi and rawo modes (i.e., "raw" input and output) to prevent the 
rest of MCS from performing any transformations on data to or from the terminal. 
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SECTION 2 


USE OF TERMINALS ON MULTICS 


ASCII CHARACTER SET 


The Multics standard character set is the revised U.S. ASCII Standard 
(refer to USA Standards Institute, "USA Standard X3.4-1968"). The ASCII set 
consists of 128 7-bit characters. These are stored internally, right-justified, 
in four 9-bit fields per word. The two high-order bits in each field are expressly 
reserved for expansion of the character set; no system program may use them. 
Any hardware device that is unable to accept or create the full character set 
should use established escape conventions for representing the set (see "Escape 
Characters" below). There are no meaningful subsets of the revised ASCII character 
set. i 


The ASCII character set includes 94 printing graphics, 33 control characters, 
and the space. Multics conventions assign precise interpretations to all the 
graphics, the space, and 10 of the control characters. The remaining 23 control 
characters are presently reserved. 


Printing Graphic Characters 


The printing graphic characters are the uppercase alphabet, the lowercase 
alphabet, digits, and a set of special characters. The special characters are 
listed below. 


! exclamation point 3; semicolon 

" double quote < less than 

# number sign = equals 

$ dollar sign > greater than 
% percent ? question mark 
& ampersand @ commercial at 
‘ acute accent [ left bracket 
( left parenthesis \ left slant 

) right parenthesis ] right bracket 
* asterisk “ eircumflex 

+ plus underline 

» comma “ grave accent 
- minus { left brace 

» period ! vertical bar 
/ right slant } right brace 

: colon ~ tilde 


Note: The solid vertical bar (|) and the broken vertical bar (}) are equivalent 
representations of the graphic corresponding to ASCII code 174. 
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Table 2-1. 


ASCII Character 


set on Multics 


0 1 2 3 4 5 6 7 
000 (NUL) BEL 
010 BS HT NL VT NP CR RRS BRS 
020 
030 
O40 Space ! i # $ b & ' 
050 ¢ ) % + ; - ‘ rs 
060 0 1 2 3 4 ) 6 it 
070 8 9 : ; < = > ? 
100 @ A B Cc D E F G 
110 4H iT. J K L M N ) 
120 P Q R ss) T U V W 
1307 Y z [ \ ] : _ 
140 * a b ec d e f g 
150 h i Jj k 1 m n fe) 
160 p q r s t u Vv wW 
17 °x y Zz { } - PAD 
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Control Characters 


The following conventions define the standard meanings of the ASCII control 
characters that are given precise interpretations in Multics. These conventions 
are followed by all standard I/O modules and by all system software inside the 
T/O system interface. Since some devices have different interpretations for 
some characters, it is the responsibility of the appropriate I/0 module to perform 
the necessary translations. 


The characters designated as unused are specifically reserved and can be 
assigned definitions at any time. Until defined, unused control characters are 
output using the octal escape convention in normal output and are not printed in 
edited mode. Users wishing to assign interpretations for an unused character 
must use a nonstandard I/O module. 


If a device does not perform a function implied by a control character, its 
standard I/O module provides’a reasonable interpretation for the character on 
output. This might be substituting one or more characters for the character in 
question, printing an octal escape, or ignoring it. 


The Multics standard control characters are: 
BEL Sound an audible alarm. 


BS Backspace. Move the carriage back one space. The backspace character 
implies overstrike rather than erase. 


HT Horizontal tab. Move the carriage to the next horizontal tab stop. 
Multics standard tab stops are at 11, 21, 31... when the first column 
is numbered 1. 


NL Newline. Move the carriage to the left end of the next line. This 
implies a carriage return plus a line feed. ASCII LF (octal 012) is 
used for this character. 


NVI. Vertical tab. Move the carriage to the next vertica 
the left of the page. Standard tab stops are at 1 


M&M 


i Vis. 20 Blaws 


when the first line is numbered 1. This character, by definition, 
does not appear in a canonical string. 


tab stop and to 


a 
Ae 
120 


NP New page. Move the carriage to the top of the next page and to the 
left of the line. ASCII FF (octal 014) is used for this character. 


CR Carriage return. Move the carriage to the left of the current line. 
This character, by definition, does not appear in a canonical string. 


RRS Red ribbon shift. ASCII SO (octal 016) is used for this character. 

BRS Black ribbon shift. ASCII SI (octal 017) is used for this character. 

PAD Padding character. This is used to fill out words that contain fewer 
than four characters and that are not accompanied by character counts. 


This character cannot appear in a canonical character string. ASCII 
DEL (octal 177) is used for this character. 


2-3 Cc92-01 


Nonstandard Control Character 


One control character, NUL, is recognized under certain conditions by all 
device interface modules because of its wide use outside Multics. This character 
is handled specially only when the I/O module is printing in edited mode, and 
is, therefore, ignoring unavailable control functions. The null character is 
ASCII character NUL (octal 000). In normal mode, this character is printed with 
an octal escape sequence; in edited mode, it is treated exactly as PAD. This 
character cannot appear in a canonical character string. Programmers are warned 
against using NUL as a routine padding character and using edited mode on output 
because all strings of zeros, including mistakenly uninitialized strings, are 
discarded. 


Unused Characters 


These characters are reserved for future use: 


SOH 001 ACK 006 DCc4 024 SUB 032 
STX 002 DLE 020 NAK 025 ESC 033 
ETX 003 DC 1 021 SYN 026 FS 034 
EOT 004 DC? 022 ETB 027 GS 035 
ENQ 005 DC3 023 CAN 030 RS 036 

EM 031 US 037 


TYPING CONVENTIONS 


Three categories of typing conventions are dealt with in this discussion: 
canonical form, erase and kill characters, and escape characters. 


Canonical Form 


A character stream is a representation of one or more printed lines. Since 
the same printed line can be produced using different sets of keystrokes, there 
are several possible character streams that represent the same line. For example, 
the line: 


start lda alpha,4 get first result. 


could have been typed with either spaces or horizontal tabs separating the fields; 
one cannot tell by looking at the printed image. 


A program should be able to compare two character streams easily to see if 
they produce the same printed image. It follows that all character input to 
Multics must be converted into a standard (canonical) form. Similarly, all 
programs producing character output, including editors, must produce canonical 
form output streams. 
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Of all possible ASCII character strings, only certain strings are ever 
found within Multics. All strings that produce the equivalent printed effect on 
a terminal are represented within Multics as one string, the canonical form for 
the printed image. The user, however, is free to type a noncanonical character 
stream. This stream is automatically converted to the canonical form before it 
reaches his program. An exception to this automatic conversion is that tab 
characters are preserved; a detailed description of the conversion process is 
found later in this section. If the user wants his program to receive raw or 
partially processed input from his terminal, an escape mechanism is provided by 
the modes operation of the tty 1/0 module. The I/O module is accessed via a 
call to the iox_ subroutine (see the description of the iox_ subroutine in the 
MPM Subroutines). The modes available that apply to canonicalization are: 


can no canonicalization of overstrikes. 
ese no canonicalization of escape characters. 
“erkl no erase and kill processing. 


rawi read the specified data from the terminal without any conversion or 
processing. This includes shift characters and undifferentiated 
uppercase and lowercase characters. 


Similarly, an I/O module is free to rework a canonical stream on output 
into a different form if, for example, the different form happens to print more 
rapidly or reliably on the device. 


The current Multiecs canonical form is designed for the convenient typing of 
aligned tabular information, which requires an ambiguous interpretation of the 
tab character. The following three statements describe the current Multics canonical 
form. 


lis A text line is a sequence of character positions separated by horizontal 
carriage motion and ending in a newline character. 


ae Carriage motion consists of newline, tab, and space characters. 
36 A character position consists of a single graphic or several overstruck 
graphics. A graphic is a printable character. An overstruck character 


position consists of two or more graphics separated by backspaces. 
Regardless of the order in which the graphics are typed, they are 
always stored in ascending ASCII order. Therefore, the symbol "X", 
whether typed as; 


>B<B_ 
or 
<B>B 
or Me 
_B<B> 


is always stored internally as: 
<B>B_ 
where B is a backspace. 
There are any number of ways to type two or more consecutive overstruck 
character positions. The graphics in each position are grouped togeti.er, so 


that "X&" is always stored as: 


<B>B_<B>B_ 
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The following paragraphs give a complete set of rules for transforming a 
typed line into the form in which it is stored, followed by further examples 
illustrating the rules. The transformation process is carried out in three 
steps: canonicalization, erase/kill processing, and escape processing. If two 
or more of the rules listed below are applicable to a given input string, they 
are applied in the order in which they are presented here. 


Canonicalization 


Canonicalization is the process of converting an input string into canonical 
form. Two methods of canonicalization are defined on Multics: a method for 
printing terminals and a method for video (CRT) terminals. Both methods of 
ecanonicalization attempt to ensure that what is visible on the terminal is the 
canonical form of the input string. The method used is determined by the setting 
of the "can type" mode, as explained in the description of the tty_ I/O module 
elsewhere in this manual. 


Canonicalization for printing terminals (overstrike canonicalization) is 
designed for terminals which are capable of overstriking multiple characters in 
a single column. Any group of overstruck characters is converted to a single 
representation regardless of the order in which the characters were entered into 
the column. 


Canonicalization for video terminals (replacement  canonicalization) is 
designed for terminals which are not capable of overstriking. When a character 
is entered into a column, any characters previously present in that column are 
no longer visible. Replacement canonicalization mimics this behavior of the 
terminal by only placing the last character typed into any column into the 
canonical representation of the string. 


The canonicalization process consists of two distinct steps: column 
assignment, which is identical for both methods of canonicalization, and the 
actual canonicalization process. 


Column Assignment 

The following rules are used to determine which printing graphics, if any, 
appear in each physical column position. 

1. The leftmost position of the carriage is considered to be column 1. 


ee Each printing graphic or space typed increases the column position by 
Le 


3 Each backspace typed decreases the column position by 1 unless the 
column position is 1. 


4, A carriage return sets the column position to i. 


Be A horizontal tab increases the column position to the next tab stop; 
tab stops are defined to be at columns 11, 21, 31, etc. 


eae A newline, formfeed, or vertical tab sets the column position to 1 and 
advances the carriage vertically; thus no character typed after such a 
character can share a column position with a character typed before 
1s. 
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ie If the terminal is not in ctl_char mode, any ASCII control character 
other than backspace, horizontal tab, newline, vertical tab, formfeed, 
and carriage return is discarded. If the terminal is in ctl char 
mode, such characters are treated as if they were printing graphics 
(with the exception of the NUL character, which is always discarded). 
The default is that ctl_char mode is off. 


Overstrike Canonicalization 


The following rules determine the formation of the canonical string. 


1. Characters on each line are sorted so that their associated column 
positions are monotonically increasing. 


2% No carriage return characters may appear in the canonical string. 


3. A horizontal tab is preserved as typed unless a printing graphic appears 
in one of the columns skipped by the tab, in which case the tab is 
replaced by an appropriate number of spaces. 


4H, Backspaces appear in the canonical string only when two or more printing 
graphics share a column position. 


5. When two or more different printing graphics share a column position, 
the characters are sorted as follows: graphic with lowest numeric 
ASCII code, backspace, graphic with next lowest numeric ASCII code, 
ete. 


6. If the contents of a column position consist of two or more instances 
of the same printing graphic, that column is reduced to a single instance 
of the graphic. 


ie A line-ending character (newline, formfeed, or vertical tab) immediately 
follows the last printing graphic in the rightmost column position on 
the line. 


Overstrike Canonicalization Examples 


Several illustrations of canonical form are shown below. Assume that the 
typist's terminal has horizontal tab stops set at 11, 21, 31, etc. 


Typist: this is ordinary text.N 
Typed line: this is ordinary text. 
Canonical form: this is ordinary text.N 


where N is the newline character. In most cases, the canonical form is the same 
as the original key strokes of the typist, as above. 


Typist: here fullBBBB means thatN 
Typed line: here full means that 
Canonical form: here Bf Bu_Bl_ Bl means thatN 


where B is a backspace and N is a newline character. This is the most common 
type of canonical conversion, done to ensure that overstruck graphics are stored 
in a standard pattern. 
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Typist: We see no probSBlemC_ N 
Typed line: We see no problem 
Canonical form: WB_ Be see no problemN 


where B is a backspace, N is a newline character, S is a space, and C is a 
carriage return. The space between "prob" and "lem" was not overstruck; it and 
the following backspace were simply removed. Note the difference in the storage 
of the characters that were overstruck in this and the preceding exampie; the 
ASCII code value of the underscore is between the values for uppercase and 
lowercase letters. 


Replacement Canonicalization 


Replacement canonicalization is designed for use on a terminal with the 
following characteristics: 


® Overstriking a character with any other printing character or a space 
causes the first character to be erased, 


@ Entering a tab character simply moves the cursor position to the next 
tab stop (column 11, 21, etc.) without erasing any intervening characters. 


The following rules determine the formation of the canonical string: 


1. Characters on each line are sorted so that their associated column 
positions are monotonically increasing. 


26 No carriage return characters may appear in the canonical string. 


3. A horizontal tab is preserved as typed unless a printing graphic appears 
in one of the columns skipped by the tab, in which case the tab is 
replaced by an appropriate number of spaces. 


4, When two or more characters (including space and identical printing 
graphics) share a column position, the last character entered by the 
user in that column is kept and all other characters in that column 
discarded. 


oon A line-ending character (newline, formfeed, or vertical tab) immediately 
follows the last printing graphic in the rightmost column position on 
the line. 


With replacement canonicalization, as seen above, it is not possible to 
overstrike two characters, as the last one typed is always the only character in 
that column. Thus it is not possible to use the feature of overstriking a 
character with the erase character, as described in the "Erase and Kill Characters" 
section following, to delete a character typed in the middle of a line. Instead, 
to delete such a character, you must reposition to the character in question and 
retype the remainder of the line being input. 


Therefore, you may want to disable the erase character when using replacement 
canonicalization. This may be accomplished by the command line: 


set_tty -edit \400 


where \400 is a character which cannot normally be entered on the terminal. 
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Replacement Canonicalization Examples 


Several illustrations of canonical form are shown below. Assume that the 
typist's terminal has horizontal tab stops set at 11, 21, 31, etc. 


Typist: this is ordinary text.N 
Sereen contents: this is ordinary text. 
Canonical form: this is ordinary text.N 


where N is the newline character. In most cases, the canonical form is the same 
as the original key strokes of the typist, as above. 


Typist: this is a msitake.BBBBBBBisN 
Sereen contents: this is a mistake. 
Canonical form: this is a mistake.N 


where B is a backspace and N is a newline character. This example illustrates 
the correction of errors in the middle of a typed line. It is the most common 
use of replacement canonicalization. 


Typist: this si a strange BBBBBBBBBBBBBisHHBBexample.N 
Sereen contents: this is a strange example. 
Canonical form: this is a strange example.N 


where B is a backspace, H is a horizontal tab, and N is a newline character. 
This example illustrates that the horizontal tab character does not erase intervening 
characters (" a strange" in this example). 


Typist: This is some text.BBBBBBBBBBBBsome text. N 

Sereen contents: This is some text. 

Canonical form: This is some text.N 
where B is a backspace and N is a newline character. This example illustrates 
that in order to erase extra whitespace ina line, the typist must position to 


. the first extraneous character, retype the remainder of the line, and type sufficient 
spaces at the end of the line to overstrike any extra undesired characters. 


If, in the above example, the final spaces are not typed, the following 
occurs’: 
Typist: This is some text.BBBBBBBBBBBBsome text.N 


Sereen contents: This is some text.t. 
Canonical form: This is some text.t.N 


Erase and Kill Characters 
Two capabilities for minimally editing the line being typed are available. 
They are: 
® The ability to delete the latest character or characters (erase) 
e The ability to delete all of the current line (kill) 


By applying canonical form to these two editing functions, it is possible to 
interpret unambiguously a typed line in which editing was required. 
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The first editing convention reserves one graphic as the erase character. 
On Multiecs, the default erase character is the number sign (#). The user can 
designate a different character by invoking the set_tty command with the -edit 
control argument. Although the erase character is a printed graphic, it does 
not become part of the line. When it is the only graphic in a print position, 
it erases itself and the contents of the previous print position. Several successive 
erase characters erase an equal number of print positions. One erase character 


(any combination of tabs and spaces is called white space). The number sign can 
be struck over another graphic. In this case it erases the print position on 
which it appears. For example, typing: 


theSSne###tnext 
or 

theST#next 
or 

thetinext 


thenext 


Since processing of erase characters takes place after the transformation to 
canonical form, there is no ambiguity as to which graphic character has been 
erased. The printed image is always the guide. 


The second editing convention reserves another graphic as the kill character. 
On Multics, the default kill character is the commercial at sign (@). Again, 
the user can redesignate this. When this character is the only graphic in a 
print position, the contents of that line up to and including the kill character 
are discarded. Again, since kill processing occurs after the conversion to 
canonical form, there is no ambiguity about which characters have been discarded. 


By convention, an overstruck erase character is processed before a kill 
character, and a kill character is processed before a nonoverstruck erase character. 
Therefore, the only way to erase a kill character is to overstrike it with an 
erase character. 


Because of their special meanings to Multics, these two graphics should be 
avoided in software. 


The following rules apply to erase and kill characters. 


1. If the terminal is in ese mode, an erase or kill character alone ina 
column immediately preceded by an escape character alone in a column 
is not processed as an erase or kill character. 


Ze An erase character alone in a column position and preceded by more 
than one blank column results inthe deletion of all immediately preceding 
blank columns, as well as of the erase character. 


3. An erase character alone in a column position results in the deletion 
of itself and of the contents of the preceding column position. 


4, An erase character sharing a column position with one or more printing 
graphics results in the deletion of the contents of that column position. 


5. A kill character results in the deletion of its own column position 
and all column positions to its left, unless it shares a column position 
with an erase character, in which case rule 4 applies (the kill character 
is erased). 
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Notice that for rule number 1 to apply, the erase or kill character must 
actually have been typed in the column immediately following the escape character. 
The reason for this is that it facilitates the erasing of escape sequences, 
e.g., \OOTHHH#H. 


Typist: abex#deSBfzz#titon 

Typed line: abex#defzz#tig 

Canonical form: abcx#defzz##gn 

Final input: abcdefgN 

Typist: this@In the offBBB  ##nB_ stateN 
Typed line: this@In the off#in state 
Canonical form: In the _Bo Bn stateN 

Final input: In the on state 


Escape Sequences 


Some terminals cannot print all 128 ASCII characters. To maintain generality 
and flexibility, standard software escape conventions are used for all terminals. 
Each class of terminal has a particular character assigned to be the software 
escape sequence character in the terminal type file. When this character occurs 
in an input (or output) string to (or from) a terminal, the next character (or 
characters) are interpreted according to the conventions described below. The 
escape sequence character should not be confused with the ASCII ESC, which is 
octal 033. 


The standard escape sequence character in Multics is the left slant (\); 
like the erase and kill characters, it should be avoided in Multics software. 
The universal escape conventions are: 


1. The string \did2d3 represents the octal code d1 d2 d3 where di is a 
digit from zero to seven. Any arbitrary character can be represented 
this way. The string \d2d3 is equivalent to \d1d2d3 if d1 is zero. 
The string \d3 is equivalent to \did2d3 if d1 and d2 are zero. 

2% Local (i.e., concealed) use of the newline character that does not go 
into the computer-stored string on input, and is not in the computer-stored 
string on output, is effected by typing \<newline character>. 

3. The characters \# place an erase character into the input string. 

4, The characters \@ place a kill character into the input string. 

BS The characters \\ place a left slant character into the input string. 

The escape conventions described in items 1 through 5 above apply only if none 
of the characters involved are overstruck. 

The following rules apply to escape sequences. 

ie An escape sequence consists of an escape sequence character alone in 
its column position followed by one or more printing graphics each of 
which is alone in its column position. An escape sequence is replaced 
by a single character in the canonical string. 


2. An escape sequence consisting of two successive escape sequence characters 
is replaced by an escape sequence character. 
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An escape sequence consisting of an escape sequence character followed 
by an erase or kill character is replaced by an erase or kill character. 


An escape sequence consisting of an escape sequence character followed 
by one, two, or three octal digits is replaced by the character whose 
ASCII value is represented by the sequence of octal digits. 


saniueancrse anharanteor Ff 
Lede 8 Mw btw ww wise ds WY UWS a 


fot s aran 
wa J 1 a au 
letion of both characters from the canonical string. 


Oty 
@O (Dd 


Other escape sequences may be defined on a per-terminal-type basis, 
where such a sequence consists of an escape sequence character and one 
character following. 


If the character following an escape sequence character does not result 
in an escape sequence as defined by the six rules above, the escape 
sequence character and following characters are stored as they appear 
on the line. 


TYPING CONVENTION EXAMPLES 


In the examples below, the following conventions are used: 


N represents a newline 


C represents a carriage return, assuming that the mode lfecho 
is not set 


B represents a backspace 

T represents a horizontal tab 

S) represents a space 

{nnn} represents a character whose ASCII value is nnn (octal) 
\ is the escape sequence character 

tt is the erase character | 

e@ is the kill character 


The examples in the first group illustrate how various typed sequences are 
canonicalized in terms of column position; these are followed by examples of 


erase, 


kill, and escape canonicalization. In the second group, lines are shown 


as they appear physically, with no consideration given to the precise sequence 
of keystrokes that might have produced them. 


Column Canonicalization Examples 


Typed: 


nothing special about this line.N 


Appearance: nothing special about this line. 


Result: 


nothing special about this line.N 
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Typed: extraneous white sSBpace is ignored.CSN 
Appearance: extraneous white space is ignored. 


Result: extraneous white space is ignored.N 


Typed: Here are two ways (2B _) to overstrike.C N 


Appearance: Here are two ways (2) to overstrike. 


Result: HB__Be_ Br_Be are two ways (2B_) to overstrike.N 
Typed: tab + backspace isTBreduced to spaces.N 
Appearance: tab + backspace is reduced to spaces. 
Result: tab + backspace isSSSSreduced to spaces.N 


NOTE: See rule 3 under "Formation of the Canonical String" above. 


Erase, Kill, and Escape Examples 


The first few examples illustrate erase and kill processing; the remaining 
examples illustrate both escape processing and erase and kill processing. These 
examples assume the terminal is in ese mode (mentioned in rule 1 under "Erase 
and Kill Characters" and described in the tty I/O module) and that overstrike 
canonicalization is being used. 

Typed: abz#cde 
Appearance: abzi#cde 


Result: abcde 


Typed: abSSS#ede 
Appearance: ab #eode 


Result: abede 


Typed: not@neverSobBénSMonday. 
Appearance: not@never ofn Monday. 


Result: never on Monday. 


Typed: nox#wBBBBB S_sit'sSright. 
Appearance: nox#w it's right. 


Result: now it's right. 
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Typed: 
Appearance: 


Result: 


Typed: 
Appearance: 


Result: 


Typed: 
Appearance: 


Result: 


Typed: 
Appearance: 


Result: 


Typed: 
Appearance: 


Result: 


Typed: 
Appearance: 


Result: 


Typed: 
Appearance: 


Result: 


noxBBB BéwB Sit'sSright. 
nox#w it's right. 
noxw it's right. 


NOTE: Erase character is overstruck; see rule 4 under "Erase and 
er a 


wewut L - a 


Kill Charact 


afl! Waeen 
do VU Ce 


delSrrsScharS(1)SstaticSinit("\017#6") ; 
del rrs char (1) static init("\017#6"); 


del rrs char (1) static init("{016}"); 


\023B_ 
\023 
{002}3 


NOTE: Overstruck 3 is not part of escape sequence. 


\B_112 
\112 
\112 


NOTE: Overstruck \ is not an escape character. 


a\d#i#b 

a\#ib 

a\b 

NOTE: According to rule 1 under "Erase and Kill Characters," the 
first # is not an erase character; according to rule 3 under 
"Erase and Kill Characters," the second # erases itself and 
the preceding #. 

a\@#b 

a\@#b 

a\b 


NOTE: Same note as in immediately preceding example. 


a\B#@b 
akeb 
b 


NOTE: The \ is erased by the overstruck #. 
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Typed: a\\#b 
Appearance: a\\#b 
Result: a\#b 
NOTE: According to rule 1 under "Erase and Kill Characters," erase 
canonicalization does not recognize the #; according to rule 
2 under "Escape Sequences," escape canonicalization recognizes 
\\ and attaches no special meaning to the #. 
Typed: a\\##b 
Appearance: a\\##b 
Result: a\b 
NOTE: According to rules 1 and 3 respectively under "Erase and Kill 
Characters," the first # is not an erase character and the 
second # erases itself and the preceding #; according to rule 
2 under "Escape Sequences," \\ reduces to \. 
Typed: a\\###b 
Appearance: a\\###b 
Result: a\b 
NOTE: The first # is not an erase character; the next two are, 
erasing the second \ and the first #. 
Typed: a\\####D 
Appearance: a\\####b 
Result: ab 
NOTE: The first # is not an erase character, and must be erased 
before the two \ characters. The previous examples illustrate 
the difficulty of erasing a double \; the clearest method is 
- probably to overstrike (akkb). 
Typed: aé¢<#b (typed on an IBM Model 2741-like terminal) 
Appearance: aé¢<#b 
Result: a\b 


NOTE: Only the < is erased; ¢ is translated to \ (see "Escape Conventions 
on Various Terminals" below). 


Certain transformations are performed on output destined for a terminal to 
ensure that it is displayed correctly. These transformations can be broken down 
into the following categories: earriage motion, delays, escape sequences, 
continuation lines, and end-of-page processing. 
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Carriage Motion 


Six entries in the terminal's special characters table specify the character 
sequences to be output when any of the various carriage motion (space, formfeed, 
vertical tab, horizontal tab, backspace, carriage return, and newline) characters 
are encountered (for information on this table, see the description of the set_special 


ge eee ~ Sn oa oem ee aN Th oH maak aa tae aie aa Sal de ee NO) ome aes a ae es Be as var es: 
order to the tty 1/0 module). The most usual case is that the sequence for 


newline consists of carriage return followed by newline (i.e., linefeed), and 
each of the other sequences either consists of the source character itself or is 
null to indicate that the specified function is not available. 


In general, carriage motion is reduced to its simplest and most efficient 
form. Any combination of consecutive carriage motion characters is output as 
net right or left motion, e.g.: 


SSBSS 
is output as: 

SSS 
where S is a space and B is a backspace. If a newline immediately follows other 
carriage motion characters, those carriage motion characters are omitted. In 
addition, a combination of spaces and horizontal tabs that moves the carriage to 
or over a tab stop is converted to tabs followed by the minimum possible number 
of spaces. Tab stops are assumed to be at columns 11, 21, 31, ete. Thus the 
following sequence (starting at column 1): 

abedSsSsSSSSSSSef 
is converted to: 


abcedTsSSef 


where S is a space and T is a horizontal tab. An exception arises if the 
terminal is in “tabs mode or if the special characters table specifies a zero-length 
sequence for horizontal tabs. In either of these cases, all rightward carriage 
motion is output as spaces; as many spaces are output as necessary to reach the 
appropriate column position. 


Net léft carriage motion is normally output as backspaces unless the final 
column position is so near the left margin that it is more efficient to output a 
carriage return followed by spaces. Thus: 

abedefgCSSSS_ 
is output as: 

abcdefgBBB_ 
whereas: 

abedefghijkBBBBBBBBB _ 
is output as: 


abedefghijkCSS __ 


where C is a carriage return, S is a space, and B is a backspace. 
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If the terminal lacks the capability to perform a carriage return without a 
linefeed, the carriage return sequence in the special characters table should be 
null, in which case net left carriage motion is always output as backspaces. 
Conversely, if the terminal lacks the backspace function, the backspace sequence 
should be null, and all net left carriage motion is output as a carriage return 
followed by spaces. If both sequences are null, net left carriage motion is 
ignored. 


Delays 


Printing terminals frequently require more than one character time to move 
the carriage in any way other than one position to the right. In order to allow 
the terminal time to reach the column position in which it is next supposed to 
print, MCS may output one or more ASCII NUL characters following a carriage 
motion character. NUL characters used in this way are called delays. 


The number of delays required in any given situation depends on the terminal 
mechanism, the distance the carriage has to travel, and the speed at which 
characters are sent to the terminal (baud rate). The delay table (described 
under the set_delay order to the tty_ I/0 module) contains values, appropriate 
to the particular terminal and baud rate, that determine the number of delays 
required for any carriage motion character causing a number of columns to be 
traversed. The terminal type file (TIF), described in Section 3, contains a 
specification of delay tables to be used at various speeds for each terminal 
type. To construct a new terminal type entry, it may be necessary to obtain 
formulas from the terminal manufacturer from which the necessary delay table 
values can be derived. 


Output Escape Sequences 


A character that a particular terminal is incapable of printing may be 
represented by an escape sequence. The substitution of an escape sequence for a 
particular character is dictated by that character's entry in the output conversion 
table (described under the set_output_conversion order to the tty_ I/0 module). 
Two kinds of escape sequences are defined: octal escape sequences, and special 
escape sequences. An octal escape sequence, as explained earlier, consists of a 
left slant character followed by three octal digits representing the ASCII value 
of the character being replaced (e.g.,\012). A special escape sequence is one 

specified in the special characters table, and consists of zero to three arbitrary 

characters. Each special escape sequence has two forms, one used in edited mode 
and one used in “edited mode. See the descriptions of the set_output_conversion 
order, the set_special order, and edited mode for the tty_ I7O0 moduie for more 
detailed information. 


Continuation Lines 


When the length of an output line (i.e., the number of column positions 
between two newline characters) exceeds the terminal's physical paper or screen 
width, a newline sequence is inserted and the excess characters appear on the 
following line, preceded by a continuation sequence consisting of the characters 
NG: A "line" of arbitrary length can be output using as many continuation 
lines as necessary. The physical line length of the terminal is made available 
to the software by means of the line length (11) mode of the tty_ I/O module. 
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j End-of-page Processing 


The page length (pl) mode of the tty_ I/0 module may be used to specify the 
physical length in lines of a page. This feature is primarily of interest to 
users of video display terminals as a means of preventing output from being 
scrolled off the screen before it can be read. If page-length checking is 
enabled, tnen the last line of a page contains a warning string consisting of 
the end-of-page sequence specified in the output conversion table (described 
under the set_output conversion order to the tty_ I/0 module); this sequence is 
normally the characters "EOP". The output stops when the page is full, and 
restarts when the user types a newline or formfeed character. If the end-of-page 
sequence is a null string, output stops at the right margin of the last line of 


the page, and no warning string is displayed. See the descriptions of pl and 
seroll modes for further information. 


ESCAPE CONVENTIONS ON VARIOUS TERMINALS 


The following paragraphs list escape conventions for some of the terminals 
that can be used to access the Multics system. In general, the conventions 
described here apply to logging in and out as well as to all other typing. For 
user convenience, terminals should support the full (128 characters) ASCII character 
set on input and output. For terminals that do not have a full ASCII character 
set, escape conventions have been provided. Any of these escape conventions, 
however, can be respecified by the user. 


] Selectric Devices 
Each typeball used requires a different set of escape conventions. 


With the EBCD typeball number 963, the following non-ASCII graphics are 
considered to be stylized versions of ASCII characters: 


¢ (cent sign) for \ (left slant, software escape) 
: (apostrophe) for : (acute accent) 
- (negation) for ‘ (circumflex) 


The following escape conventions have been chosen to represent the remainder 
of the ASCII graphics. 


¢! for * (grave accent) 
é< for [ (left bracket) 
¢> for ] (right bracket) 
¢ ( for { (left brace) 

¢) for } (right brace) 
et for ~ (tilde) 


With the correspondence typeball number 029, the following non-ASCII graphics 
are considered to be stylized versions of ASCII characters. 


¢ (cent sign) for \ (left slant) 
' (apostrophe) for (acute accent) 
+ (plus-minus) for “  (eircumflex) 
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The following escape conventions have been chosen to represent the remainder 
of the ASCII graphics. 


é ( for < (less then) 

¢) for > (greater than) 

él for [ (left bracket) 

er for ] (right bracket) 

@: for ! (exclamation point) 
t for e (tilde) 

¢! for : (grave accent) 

¢/ for } (vertical bar) 


NOTE: The left and right braces ({ and }) must be input using octal escapes 
(¢173 and ¢175) when using the correspondence typeball. 


Upper Case Only Devices 


Because these models do not have both uppercase and lowercase characters, 
the following typing conventions are necessary to enable users to input the full 
ASCII character set: 


1. The keys for letters A through Z input lowercase letters a through z, 
unless preceded by the escape character \ (left slant). The left 
slant is shift-L on the keyboard, although it does not show on all 
keyboards. For example, to input "Smith.ABC", type "\SMITH.\A\B\C". 


2 Numbers and punctuation marks map into themselves whenever possible. 
The underscore (_) is represented by the back arrow (€-). The circumflex 
(*) is represented by the up arrow (fT). The acute accent (%) is 
represented by the apostrophe ('). 

3 The following other correspondences exist: 


Character type in octal 


backspace \- 010 
grave accent (*) \! 140 
left brace (1) a! 173 
a vertical line (1) \! 174 
right brace (}) \) 175 
tilde (7) \= 176 


Execuport 300 


The following non-ASCII graphics are considered to be stylized versions of 
ASCII characters: 


back arrow (€=) for underscore (_) 
CDI Model 1030 
The following non-ASCII graphics are considered to be stylized versions of 


the ASCII characters: 


back arrow (€-) for underscore ( ) 
up arrow (fT) for circumflex (*) 
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FLOW CONTROL 


Some asynchronous terminals implement a flow control protocol for input 
and/or output. The following paragraphs describe briefly the mechanisms supported 
by the Multics system. 


Input Flow Control 


For terminals that can be used to send high-speed input using a paper tape 
or cassette tape reader, it is useful for the system to be able to instruct the 
terminal to stop and start transmission so that the input does not arrive faster 
than it can be processed. Such terminals (for example the Tektronix 4051) suspend 
transmission on receipt of a particular character (called the input_suspend 
character), and resume it on receipt of another character (the input resume 
character). In addition, such terminals sometimes suspend input at the end of 
each tape record or block, possibly transmitting the input suspend character 
before doing so. It is the responsibility of the system in this case to request 
the resumption of input by sending the input_resume character. The input_suspend 
and input resume characters may be specified in the description of the terminal 
type as described in Section 3, or by means of the input flow control chars 
order to the tty I/O module, described in Section 6. The timeout option is 
used to specify that the terminal suspends input without transmitting an 
input_suspend character, and that the system must send an input_resume character 
when it detects that input has been suspended. Input flow control is enabled 
and disabled by means of the iflow mode of the tty_ I/O module. 


Output Flow Control 


Output flow control is intended to manage terminals that buffer output, 
since they print or display at less than channel speed. Two types of output 
flow control protocols are supported by the Multics system. The first, called 
suspend/resume, is used by various terminals including several made by Digital 
Equipment Corporation. In this protocol, the terminal sends a particular character 
(called the output suspend character) when its buffer is nearly full in order to 
request that the system temporarily stop sending output. When it is ready to 
accept more output it sends another character (the output_resume character). 
The other’protocol, called block acknowledgement, is used by various terminals, 
including the Diablo 1620. In this protocol, the system is expected to subdivide 
output into blocks no larger than the terminal's buffer, and end each block with 
a specific character (the end_of_block character). When the terminal is ready 
to accept more output, it transmits an acknowledgement character. The type of 
protocol and the specific characters to be used can be specified in the terminal 
type description as described in Section 3, or by use of the output_flow_control_ chars 
order to the tty 1/0 module, described in Section 6. Output flow control is 
enabled and disabled by means of the oflow mode of the tty_ I/O module. 


BLOCK TRANSFER 


Some asynchronous terminals are capable of operating in "block mode", i.e., 
they can be made to buffer a block of data and then transmit it at channel speed 
in response to a single keystroke. The system may not handle such high-speed 
input correctly unless it is informed that the terminal is capable of such 
transmission. The blk_xfer mode of the tty _ I/0 module is used for this purpose. 


2-20 CC92-01 


A terminal is suitable for use in blk xfer mode if it delimits the block or 
"frame" of data transferred by appending a specified character (the “frame end" 
character) to the block and optionally preceding the block with a "frame begin" 
character (which need not be different fromthe frame _end character). The particular 
characters used will depend on the terminal. The characters used can be specified 
by the framing chars statement in the terminal type definition as described in 
section 3, or by means of the set_framing chars order to the tty_ I/O module. 


If the terminal is in blk_ xfer mode, and frame begin and frame_end characters 
have been specified, all characters starting with a frame _begin character, up to 
and including the next following frame_end character, are treated as a frame. 
If a frame _end character has been specified, but no frame begin character has 
been specified, then all characters between one frame_end character and the next 
are treated as a frame. In general, none of the characters in a frame are 
delivered to the user's process until the end of the frame has been reached. 
Calls to iox $get line still read input one iine at a time, but the first line 
in a frame is not available for reading until the entire frame has been received. 
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SECTION 3 


TERMINAL TYPES 


TERMINAL TYPE CONCEPT 


A terminal type is a named set of parameters identifying the characteristics 
and behavior of a terminal. The following attributes are components of a terminal 
type: . 
character set 
code set (e.g., EBCDIC, ASCII, etc.) 
behavior in response to carriage movement characters 
behavior in response to other control sequences 


time required for carriage movement functions (delays) 


software control of horizontal tabs 


line length and page length 


These parameters are used by MCS to determine how to format output to, and 
interpret input from, the terminal. The specification of these individual parameters 
can be changed independently; the terminal type provides a mechanism for specifying 
them all at once without having to know the details of their implementation. 


Terminal Type and Line Type 


It is important to distinguish between terminal type and line type, both of 
which terms are used in describing a terminal connection to Multics. A line 
type defines the communications protocol used on a particular channel; it is a 
characteristic of a channel rather than of a terminal. The terminal type may be 
changed by the user in order to modify the system's treatment of the terminal; 
the line type is determined by the system, and cannot be changed while the 
channel is in use. 


TERMINAL TYPE TABLE AND TERMINAL TYPE FILE 


Terminal types are defined in a data base called the terminal type table 
(TTT). There is a system-wide TTT that is used by default; each process, however, 
can use its own TTT instead. The TIT being used by a process can be changed by 
means of the set_ttt_path command. The various entries of the ttt_info_ subroutine, 
described in Section 5, can be used to extract information from the TIT. The 
print terminal types command lists the names of all terminal types defined in 
the TIT; the display ttt command displays the contents of the TIT in readable 
format. These commands are all described in Section 4. 
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The TTT is derived from an ASCII segment, suitable for creation and modification 
using a text editor, called the terminal type file (TTF). A TIT is generated 
from a TIF by means of the cv ttf command, also described in Section 4. The 
syntax of a TTF is described later in this section. 


Setting Terminal Types 


Every terminal connected to the Multics system has a terminal type associated 
with it at all times. The terminal type associated with a particular terminal 
may be set in any of the following ways: 


As When the terminal dials up (i.e., a connection is established), its 
terminal type is set in accordance with its line type and baud rate as 
specified in the default type table in the TIT (see "Syntax of the 
TTF" below). 


re channel on which the terminal dialed up has an initial terminal 
type associated with it in the channel definition table (CDT), that 
terminal type is assigned to the terminal. See the MAM Communications 
for more information on the CDT. 


3% If the terminal provides an answerback sequence that matches one of 
the answerback specifications in the TTT (see "Syntax of the TTF"), 
its terminal type is set according to the answerback. 


4, If the user specifies the -terminal type control argument to the login 
command or uses the terminal type preaccess request, the terminal type 
is set accordingly. See the description of the login command and 
terminal type pre-access request in the MPM Commands. 


5s The user may, at any time, change his terminal type by invoking the 
set_tty command with the -terminal type control argument. 


Changing Terminal Type Definitions 


A user wishing to invent a new terminal type, or change the characteristics 
of an existing terminal type, may edit a copy of the system-supplied TTF and 
create a new TIT by using the cv_ttf command. Whenever he wishes to use the new 
or redefined terminal type(s), he switches to the new TIT by means of the set_ttt_path 
command, and then uses the set tty command to change his own terminal type to 
the desired one. This change affects only his current process; other users of 
the same non-standard TIT are not affected until they use the set_tty command to 
set or change terminal type. 


Note: Various sequences of characters beginning with the ASCII "escape" 
character (octal 033) are treated by some terminals, when sent as 
output, as commands to the terminal. These commands may have unexpected 
or undesirable effects on the behavior of the terminal if, for example, 
they are embedded in a piece of online mail. For this reason, the 
standard TTT distributed by Honeywell is designed to prevent the 
escape character from being included in normal output for most terminal 
types. Users or sites providing their own TTITs should be aware of 
the hazards of allowing escape sequences to be sent to terminals as 
a matter of course. 
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Terminal Type Table 


The terminal type table (TIT), a data base that resides by default in the 
segment: 


>system_control_1>ttt 


describes all the terminal types used by MCS. The initializer requires write 
access to this segment; all other users require read access. 


The TTT is a binary table containing numbers and pointers as well as character 
Strings; therefore, it cannot be examined or modified using the editors. The 
display ttt command is used to print out all or part of the TIT; when the system 
administrator wishes to add or delete terminal types, or change the information 
about one or more terminal types, he compiles a TTF into a TIT using the ev ttf 
command, and then uses the install command to signal the initializer to replace 
the copy of the TTT in the system. 


A TTT is supplied by Honeywell that includes, but is not limited to the 
following terminal types: 


Terminal Type 
ASCII CAPS 


ASCII_CRT_CAPS 


Description 


Typical ASCII teleprinter terminal 
(uppercase only) 
Typical ASCII ert terminal (uppercase only) 


ADM3A _ Lear Siegler Model ADM-3A 

AJ630 Anderson-Jacobson Model 630 

AMBASSADOR Ann Arbor Ambassador CRT 

CONCEPT100 Human Designed Systems Concept 100 
DIABLO1640 Diablo Systems Series 1640 
HAZELTINE1510 Hazeltine Model 1510 

HEATH19 Heath Model H19 

IBM3271 Control unit for IBM3270 terminal cluster 
INFOTON100 Infoton 100 Display Terminal 
IRISCOPE200 Iriscope 200 

LO6FTF Honeywell L6 File Tranmission Facility 
LA120 Digital Equipment LA120 DECwriter III 
LED120 Triformation Systems braille terminal 
NEC5520 Nippon Electric Model 5520 (Spinwriter) 
NEC5525 Nippon Electric Model 5525 (Spinwriter) 
SARA Honeywell SARA 20 

SYSTEM75 Selecterm System 75 

TEK4023 Tektronix 4023 

TEK4025 Tektronix 4025 

TELERAY1061 Teleray 1061 

TRANSLEX ECD Translex Intelligent Terminal 
TVI920 TeleVideo Model TVI-912 and 920 


VIP7700 CLUSTER 


Honeywell Multiple Interface Unit for Series 
VIP7700 Polled VIP Terminal 


VIP7705 Honeywell VIP7700 Polled VIP Display Terminal 
(upper and lower case) 

VIP7714 Honeywell VIP7714 read only printer 

VIP7760 Honeywell VIP7760 Display Station 

VIP7705R Honeywell VIP7700R Polled VIP Display Terminal 


VIP7760_CONTROLLER 
VIP7804 
VIP7804_CLUSTER 


(upper and lower case) 
Honeywell VIP7760 Controller 
Honeywell VIP7804 Polled VIP Display Terminal 
Honeywell Multiple Interface Unit for Series 
VIP7804 Polled VIP Terminals 
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VISTAR Infoton Vistar Satellite terminal 
VT100 Digital Equipment Model VT-100 


These terminal types can change at any time, so the user should invoke the 
print terminal types command to verify the current types. ; 


SYNTAX OF THE TTF 


The TIF defines all terminal types known to the system. It is an ASCII 
file which, when compiled into a binary table (the TTT), is installed by the 
initializer at the system administrator's request. 


The TTF consists of a series of entries describing terminal types, tables, 
and answerback interpretations. Each entry consists of a series of statements 
that begin with a keyword and end with a semicolon. White space and comments 
written in the same style as PL/I comments enclosed by /* and */ may appear 
between any tokens in the TTF. The last entry in the TTF must be the end 
Statement. Global statements specifying defaults may appear anywhere before the 
end statement; the defaults they specify are in effect for all subsequent terminal 
type entries, until they are overridden by subsequent global statements. Except 
for the end statement, all statements consist of the statement keyword, a colon, 
the variable field of the statement, and a semicolon. 


Generalized Character Specifications 


Many statements in the TIF take as arguments single characters, or lists of 
Single characters. Statements that accept such operands are shown with the 
<tty char> notation. A <tty_char> operand may be any of the following: 


Ts A single unquoted character, such as X, A, p, $ or ~. This notation 
is only allowed for "simple" characters. This notation may not be 
used for control characters, white space, ASCII digit characters, "(", 
ae Le NEW tM, Wen, Wee ot Met or the double quote character. 


2. A single quoted character, such as "X", "5", "BM. or "O", Any ASCII 
zcode can be entered this way. Note that digits should be specified as 
HOM. TOC. Oy 


Sie A 1 to 3 digit octal number, such as 177, 14 or 007. This enters the 
character whose octal representation is as specified. Note that 0 is 
interpreted as octal 000. If the ASCII digit "0" is desired, it must 
be specified as "0" or 060. 


4, The name of a control character, such as DEL. These may be either 
upper or lower case. All standard control characters are accepted, 
including: 


NUL SOH STX ETX EOT ENQ ACK BEL (000 007) 
BS TAB LF VT FF CR SO SI (010 - 017) 
DLE DC1 DC2 DC3 DC4 NAK SYN ETB (020 027) 
CAN EM SUB ESC FS GS RS US (030 - 037) 


In addition, SP (O40), DEL (177), NL (012), and HT (011) are also 
accepted. 
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5. Control characters may also be entered in the form “A, which is read as 
econtrol-A, and is the character sent when the control-A function is 
used on an ASCII keyboard. “A is equivalent to SOH, or 001. The 
letters A-Z (upper or lower case equivalent) preceded by a "*" may be 
used for 001 through 032. Also accepted are “@ (000), “[ (033), *\ (034), 
Td 603524 9° (036),-and ~~. (O37 )s 


Terminal Type Entry 


The entry for each terminal type consists of a terminal type statement 
naming the terminal type, followed by various statements describing the attributes 
of that terminal type. Attributes not specified for a terminal type are set 
from the defaults established by global statements or supplied by the cv_ttf 
command. 


A description of each ‘statement found in a terminal type entry is given 
below. 


terminal type: <type name> {like <type name>}; 

The terminal type statement is required. It specifies the name of the 
terminal type described by the statements following it. The type name has 
a maximum length of 32 characters. All lowercase letters in the type name 
are translated to uppercase before being stored in the TTT. If the optional 
like keyword is supplied, it indicates that the attributes of the current 
terminal type are to be copied from the entry for the type whose name 
follows the like keyword, except for those that are overridden by subsequent 
statements in the current entry. The like keyword must refer to a previously 
defined terminal type. 


modes: <model>, <mode2>, ... <modeN>d; 
The modes statement is required. It specifies the modes to be set when the 
type of the terminal is assigned. A mode name may be preceded by a ~* 
character to indicate that the specified mode is off for the terminal type. 
The line-length specification (1lln) must be included in the modes statement. 
For a list of the valid modes, see the description of the tty _ I/0 module. 


function keys: <table name>; 
The function keys statement is optional. It specifies the name of a 
function key table (defined by a function key table entry) to be used for 
this,terminal. If it is omitted, or the table name is a null string, the 
terminal is assumed to have no function keys. 


initial string: <string>; 

The initial string statement is optional. If present, it specifies a character 
string to be sent to the terminal in rawo mode in order to initialize 
certain physical characteristics of the terminal (e.g., to set its horizontal 
tabs). This string is sent either at dialup time, in response to a 
"send initial string" order, or when set_tty is invoked with the 
-initial_ string control argument. The string is specified as one or more 
substrings. Each substring may be one of the following: 


1. A quoted string; e.g., "sR". If a quoted string is to contain a quote 
character, that quote must be doubled. (e.g., "s""R" is s"R). 
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2. <tty-char> 

3. (<decimal-integer>) <<substring> ... <substring>> 
where <decimal-integer> is a repetition factor enclosed in parentheses 
and followed by one or more substrings enclosed in angle brackets (< 
and>). For example: 


(10) <O40 ETX> 


represents 10 repetitions of the two character sequence consisting of 
a Space and an ETX character (octal 003). 


additional info: <string>; 


The additional info statement is optional. If provided, it specifies 
additional information which may be needed to run the terminal. This 
information is not interpreted by the standard terminal software, and is 
not passed to the supervisor; it may be used by a special I/O module used 
to run terminals of the current type. The format and contents of the 
string depend on the particular application; it may even be the pathname of 
a segment containing additional information. The string is specified in 
the same way as for the initial string statement (above). 


bauds: <baud1> <baud2> ... <baudN>; 


bps: 


cps: 


7/82 


can also be written as: 
<baud1> <baud2> ... <baudN>; 

The bauds statement is required if any delay statements (see below) are 
provided, and it must precede all delay statements. It specifies the baud 
rates to which the values supplied in the delay statements apply. A 
specification of "other" in the bauds statement means that the corresponding 
values in the delay statements apply to all baud rates not specified. If 
"other" is not specified, then delay values of Q are assumed for all baud 
rates not specified in the bauds statement. The following is a list of the 
baud rates that may be specified: 


110 300 1800 7200 
133 600 2400 9600 
150 1200 4800 19200 


<eps1> <ceps2> ... <cepsNd; 
The cps statement may be used in place of the bauds statement (above) to 
express terminal speeds in characters per second. The value stored in the 
TTT is the corresponding baud rate. The cps values that may be specified, 
and their corresponding baud rates, are listed below: 


cps value baud rate 

110 

15 150 
30 300 
60 600 
120 1200 
180 1800 
240 2400 
480 4800 
720 7200 
960 9600 
1920 19200 


Note that there is no way to express a baud rate of 133 in a cps statement. 
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<delay keyword>: 


<valueil> <value2> ... 


<valueN>; 


In each delay statement, the same number of values must be supplied as baud 


rates in the bauds, bps, 


or cps statement. 


Each value specifies the number 


of delays to be used for the character described by the delay keyword at 
the baud rate specified in the corresponding position in the bauds statement 


(see example below). 


vert_nl delays 
the number of 


delays to be 


The possible delay keywords are: 


sent with a newline operation 


(-127 < vert_nl_ delays < 127). 


horz nl delays 


the variable number of delays to be sent for each column position 


traversed by a carriage return or a newline operation. 


This; is: :4 


floating point number (0 < horz_nl_ delays < 1). 


econst_tab_delays 


the minimum number of delays to be 


sent with a horizontal tab 


(O < const_tab_ delays < 127). 


var_tab_delays 


the number of additional delays to be sent for each column position 


traversed by a horizontal tab. 


This is a floating point number 


(O < var_tab_delays < 1). 


backspace delays 
the number of 


delays to be 


sent with a backspace 


(-127 < backspace delays < 127). 


vt_ff_ delays 


the number of delays to be sent with a vertical tab or formfeed 
(O < vt_ff_delays < 511). 


Negative values for vert_nl_ delays and backspace delays have the same meanings 
as those described in the description of the set delay order to the tty 


I/O module. 
type not specified. 


Example: 
bauds: 110 
,vert_nl_ delays: 2 
horz_nl_ delays: “1 
‘const_tab delays: 0 
var_tab_delays: -1 
backspace delays: 0 
vt_ff_delays: 0 


Values of zero are assumed at all baud rates for any delay 


150 300 1200 other; 
3 6 24 30; 
1 yee .8 1; 
1 2 i 103 
P12 -32 .8 13 
0 1 3 6; 
0 O 0 0; 


The first column gives the complete set of delay values to be used at 


110 baud; 
etc. 


line _ types: 


the second column gives the values to be used at 


150 baud, 


<line_type namel>, <line_ type name2>, ... <line type nameN>; 
The line types statement is optional. 
types on which a terminal of the current type can be run. 


It specifies the names of the line 
If it is omitted, 


the current terminal type can run on any line type. 


erase: <tty chard; 


The erase statement is optional. 


terminal type. 


It specifies the erase character for the 


If it is omitted, the # character is used. 
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J kill: <tty_char>; 
The kill statement is optional. It specifies the kill character for the 
terminal type. If it is omitted, the @ character is used. 


line delimiter: <character>; 
Specifies the terminal's normal line delimiter character. The character 
must be specified as one to three octal digits in the terminal's input code 
(untranslated). This character defaults to 012 unless the line type is 


waits GAvVuvus Mien wees 


2741 or 1050, in which case it defaults to 055. 


keyboard addressing: yes/no; 
The keyboard addressing statement is optional. It indicates whether or not 
to do keyboard locking and unlocking for a terminal on a communications 
channel whose line type is ASCII. If it is not provided, a value of no is 
assumed. This attribute is ignored for channels of any other line type. 


print preaccess message: yes/no; 
The print preaccess message statement is optional. It indicates whether or 
not the answering service should print a message advising the user to enter 
a preaccess request if the user entered an unrecognized login word. It is 
useful in cases where the character code of the terminal may be different 
from what was expected. At present, only one possible preaccess message is 
defined, suitable for use with EBCD and Correspondence-code IBM 2741 terminals. 
If the print _preaccess message statement is omitted, a value of no is assumed. 


conditional printer off: yes/no; 

The conditional printer off statement is optional. It indicates whether or 
not the answerback identification of the terminal should be used to determine 
whether the terminal is equipped with the printer-off feature. If yes is 
specified, a terminal of this type is assumed not to have printer-off unless 
it has an answerback ID beginning with a digit (0 to 9); otherwise, the 
existence of the printer-off feature is deduced from the presence or absence 
of a printer-off sequence in the special characters table (see below). 
This attribute is primarily useful for IBM 2741 terminals. If the 
conditional printer _off statement is omitted, a value of no is assumed. 


input conversion: <table name>; 
The input conversion statement is optional. It specifies the name of a 
conversion table (defined by a conversion table entry) to be used in converting 
input from the terminal. If it is omitted, or the table name is a null 
String, no input conversion table is used. 


output conversion: <table name>; 
The gutput conversion statement is optional. It specifies the name of a 
conversion table (defined by a conversion table entry) to be used in converting 
output sent to the terminal. If it is omitted, or the table name is a null 
string, no output conversion table is used. 


Special: <table name>; 

The special statement is optional. It specifies the name of a table (defined 
by a special table entry) to be used as a special characters table when 
converting input and output (see "Special Characters Table Entry" below). 
If it is omitted, or the table name is a null string, no special characters 
table is used. If an output conversion table whose entries are not all 0 
is specified, a special characters table must also be specified in order 
for the terminal to function correctly. 


input_translation: <table name>; 
The input_translation statement is optional. It specifies the name of a 
table (defined by a translation table entry) used to translate input from 
the code of the terminal to ASCII. If it is omitted, or the table name is 
a null string, input is not translated. 
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output translation: <table name>; 
The output translation statement is optional. It specifies the name of a 
table (defined by a translation table entry) used to translate output from 
ASCII to the code of the terminal. If it is omitted, or the table name is 
a null string, output is not translated. 


old type: <number>; 
~ The old_type statement is optional. It may be used for compatibility purposes 
to specify the numeric value of the terminal type formeriy predefined by 
the Multics Communication System that most closely corresponds to the terminal 
type described by this terminal type entry. 


framing chars: <frame_begin> <frame_end>; 

The framing _ chars statement is Sptional. If present, it specifies the framing 
characters generated by the terminal when sending frame input at channel 
speed. The <frame_begin> and <frame_end> are <tty_chars>'s as defined above, 
In the terminal's character code they represent the frame _begin and frame end 
characters respectively (i.e., without translation). <frame __begin> can be 
NUL or 000 to indicate. that there is no frame begin character; in this 
case, all input in blk xfer mode is treated as part of a frame. 


The following statements define parameters for flow control to and from 
asynchronous terminals. For more information, see the discussion of flow control 
in Section 2. 


input_suspend: <tty_char>; 

The input _ suspend statement is optional. If present, it specifies a character 
to be transmitted to the terminal in iflow mode in order to temporarily 
suspend input or, alternatively, a character that the terminal sends to 
inform the system that it is suspending input. In either case, input is 
restarted when the input_resume character (see below) is sent to the terminal. 
This feature is appropriate for use on certain terminals which do input at 
line speed. If the input suspend statement is present, the input_resume 
Statement must also be present. 


input_resume: <tty_char> {, timeout}; 

The input_ resume statement is optional, unless the input suspend statement 
(above) is present. It specifies a character that, when sent to the terminal 
by the system while in iflow mode, causes it to resume temporarily suspended 
input. Depending on the terminal, the input suspend character (above) may 
not be required. The timeout keyword, if supplied, indicates that the 
termifial may suspend input (as at the end of atape record) without transmitting 
an input suspend character, in which case it is the responsibility of the 
system to detect this situation and send the input resume character after 
input has been suspended. If the input_resume statement is specified but 
the input suspend statement is not, the input_ resume statement must include 
the timeout keyword. 


output suspend: <tty_char>; 

The output_ suspend statement is optional. It may be used with terminals 
that implement a suspend resume protocol for output flow control. If present, 
it specifies a character that the terminal transmits to cause the system to 
suspend output so that the terminal can empty its internal buffer. The 
character is only interpreted by the system in oflow mode. Output is restarted 
when the terminal sends the output_resume character (see below). If the 
output suspend statement is specified, the output resume statement must also 
be specified, and none of the output_end_of_ block, output acknowledge, and 
buffer_size statements may be specified. ~ 
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j output resume: <tty_char>d; 
The output_resume statement is optional, unless the output_suspend statement 
is present. It specifies a character transmitted by the terminal to inform 
the system that output that was suspended in response to an output_suspend 
character (see above) can be resumed. If the output resume statement is 
present, the output _suspend statement must also be specified, and none of 
the output_end_of_ block, output_acknowledge, and buffer_size statements may 


he speci fied 


Vveaec avoue 


buffer size: <number>; 
The buffer_size statement is optional. It may be used with terminals that 
implement a block acknowledgement protocol for output flow control. If 
present, it specifies the size in characters of the terminal's output buffer, 
and is used to determine the maximum number of characters to be sent to the 
terminal at one time (in one transmission) in oflow mode. Each block of up 
to that number of characters is terminated by an output_end of_block character 
(see below). The next block is not transmitted until the terminal sends an 
output_acknowledge character. If the buffer _size statement is specified, 
the output_end_of_block and output _acknowledge statements must also be 
specified, and neither the output _suspend nor the output_resume statement 
may be specified. 


| output end of block: <tty chard; 
The output_end_of_block statement is optional. If it is present, it specifies 
a character to be appended to every output block, as described under the 
buffer size statement above. If the output _end_of_block Statement is 
specified, the output_acknowledge and buffer_size statements must also be 
specified, and neither the out put _ suspend nor the output resume statement 
can be specified. 


] output acknowledge: <tty char>; 
The output_acknowledge statement is optional. If present, it specifies a 
character that is transmitted by the terminal when it is ready to receive 
the next block of output, as described under the buffer_size statement 
(above). If the output_acknowledge statement is specified, the buffer size 


and output_end_of block statements must be specified, and neither the 
output _suspend nor the output_resume statement may be specified. 


Video Table Definition 


Aach terminal type may have an optional video table defined. MThis 
table contains control sequences for performing standard cperations on video 
terminals. The table starts with the keyword: 

video_info: 


A global video table, which will be used for all terminal types that do not 
have a video table specified, is started with the keyword: 


Video_info: 
The absence of a video table may be specified by: 
video info: ; 


This may be used to negate the effects of a global Video info statement or 
a video table inherited from a similar terminal type. 
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The video_info keyword is followed by 1 or more video info statements, 
described below. The video table is terminated by the first statement not 
in this list. 


sereen height: <decimal-integer>; 
specifies the usable number of lines on the screen. 
screen line length: <decimal-integer>; 


specifies the usable number of columns on the screen. 


The following statements describe various video control sequences. Each 
<video_sequence> is a character string built by the concatenation of all 
the operands given. The sequence may also be followed by an optional delay 
or padding specification. Video sequences may be built out of any combination 
of the following: 


<tty_char> 
quoted string, such as "sR" 
<addressingirepeat specification> 


The addressing or repeat specification is entered as follows: 
({binaryidecimal {n}ioetal int} {XixiYiyiNin} {+t- <tty_char>}) 


This specification takes the value to be sent to the terminal (X,Y,N), 
encodes it in some way (binary, decimal, octal), and.adds or subtracts a 
fixed offset (+!- <tty-char>). 


X represents the horizontal or column position on the screen (0 origin). 
Y represents the vertical or row position on the screen (also O origin). 
The upper left hand corner of the screen, usually called home, is location 
X=0, Y=0. The X and Y notations are usually used in the absolute cursor 
addressing sequence, although they may be wherever required, depending on 
the terminal. N refers to a repeat count, which some terminals support for 
some operations. 


These values may be encoded in either binary, decimal, or octal. Binary 
means byte (X), as in the PL/1 builtin. Decimal or octal causes the value 
to bevconverted to a character string representation. If in} is given, it 
must be 1, 2, or 3, and refers to the length of the character string to be 
sent, padded with leading zeroes if required. If {nt is 0, or not specified, 
no leading zeroes will be sent. For example, if X is 35, 


(decimal 3 X) -> "O35" 
(decimal X) -> nao" 
(octal 3 X) => "Oygn 
(binary X) -> ngen 
(X) -> ne 


If an offset is required, it may be specified as +!- <tty-char>. The 
value rank (tty-char) will be added to or subtracted from the number to be 
sent before it is encoded. A common example is (X + SP). In this case, an 
X of O will yield a space (octal 40), an X of 1 will yield "!" (octal 41), 
etc. 
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Any video sequence may have an optional <padding> value, expressed as 
follows: 


,» pad n {usims} 


If us (micro seconds), or ms (milliseconds) is specified, n is interpreted 
as a time vaiue. Otherwise, it is an absolute number of pad characters 
required, regardless of the baud rate. If a time is specified, the minimum 
that can be specified is 100 microseconds. All values are rounded up to 
the next multiple of 100 microseconds. The maximum value is 26.2 seconds. 
Time values are converted to a pad count at execution time, depending on 
the baud rate of the terminal. 


The following statements all use the syntaxes just described. Each 
statement also has a definition of exactly what effect the sequence has on 
the terminal. If the terminal does not have the capability to perform the 
Fin 7 
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abs pos: <video-sequence> {<padding>} ; 
defines the absolute cursor positioning sequence. This sequence moves the 
eursor to a given (X,Y). Other than the cursor, no characters on the 
sereen are affected. 

clear screen: <video-sequence> {<padding>} ; 
defines the screen clearing sequence. This sequence clears the entire screen 
to spaces regardless of where the cursor is, and leaves the cursor at home. 
This sequence does not clear tabs. 

clear_to_eos: <video-sequence> {<padding>} ; 
defines the ciear to end of screen sequence. This clears the screen from 
the current cursor position to the end of the screen. It does not move the 
cursor or clear tabs. 


home: <video-sequence> {<padding>} ; 


defines the move cursor home sequence. The cursor moves to location X=0, 
Y¥=0. 


‘elear_to_eol: <video-sequence> {<padding>} ; 
defines the clear to end of line sequence. Starting at the current cursor 
position, the rest of the current line clears to spaces. The cursor does 
not move. 

cursor_up: <video-sequence> {<padding>} ; 
defines a sequence to move the cursor up one row. It does not have any 
effect on the column. The effect of the sequence when the cursor is on the 
top line of the screen is undefined. 

cursor right: <video-sequence> {<padding>} ; 
defines a sequence to move the cursor one column to the right. It does not 


have any effect on the row. The effect of the sequence when the cursor is 
in the last column of the screen is undefined. 
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ecursor_down: <video-sequence> {<padding>} ; 


defines a sequence to move the cursor down one row. It does not have any 
effect on the column. The effect of the sequence when the cursor is on the 
bottom line of the screen is undefined. 


eursor_left: <video-sequence> {<padding>} ; 


defines a sequence to move the cursor one column to the left. It does not 
have any effect on the row. The effect of the sequence when the cursor is 
in the leftmost column of the screen is undefined. 


insert chars: <video-sequence> {<padding>} ; 


defines a sequence for inserting characters on the current iine. Let 
end_insert_chars (see next statement) is defined, insert_chars should put 
the terminal in a mode in which each character sent to the terminal is 
placed on the screen at the cursor location; each character to the right of 
the cursor is pushed one position to the right; and the cursor is moved one 
position to the right. The effect of pushing characters off the righthand 
edge of the screen is undefined. If end_insert_chars is not defined, 
insert chars is defined as opening up N (or 1) spaces on the line, pushing 
characters to the right of the cursor toward the right. The cursor does 
not move in this case. 


end_insert_chars: <video-sequence> {<padding>} ; 


defines a sequence for taking the terminal out of insert _chars mode. See 
above. 


delete chars: <video sequence> {<padding>} ; 


defines a sequence for deleting characters from the current line. The 
character at the cursor is deleted, and all characters to the right are 
moved one column to the left. A space is inserted in the last column of 
the screen. 


insert lines: <video_sequence> {<padding>} ; 


defines a sequence for inserting lines on the screen at the current cursor 
position. Aii lines starting at the current line are moved down one line. 
The current line is filled with spaces. The effect of pushing lines off 
the bottom of the screen is not defined. This sequence is only defined to 
work when the cursor is at the leftmost margin. The position of the cursor 
is not changed. 


delete lines: <video sequence> {<padding>} ; 


defines a sequence for deleting lines from the screen. The current line is 
deleted by moving ail lines below it up one line. The bottom line of the 
screen is filled with spaces. This sequence is only defined to work when 
the cursor is at the leftmost margin. The position of the cursor is not 
changed. 


Many terminals do not support all the functions described above, but 
often they can be simulated by combinations of other functions. For example, 
the Honeywell VIP7801 does not support clear_screen, as defined, because 
the clear sequence to that terminal also clears the tabs. The effect of 
this can be simulated, however, by the combination home (or abs _ pos to 0,0) 
and clear_to_eos, which will clear the screen without affecting the tabs. 
Thus a clear _screen sequence could be defined which is a concatenation of 
the other two sequences. Similarly, if a terminal did not have a cursor up 
sequence, but did support abs_pos, it would be possible to specify a cursor_up 
sequence as a variant of the abs pos sequence (by changing the offset by 
1). In general, it is not recommended that this sort of optimization be 
done in the TTF. Instead, the TTF should be viewed as describing the 
physical characteristics of the terminal, and it is the job of software to 
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choose from among the capabilities of the terminal in order to provide the 
desired effect. 


For most applications, a certain minimal set of functions is required 
to perform video functions. These are: 
i Some way of clearing the screen. Clear_screen is best, but home and 
clear_to_eos will work, as well as erase _to_eol on each lin 


@ 


2. Some way of absolute cursor addressing. Abs pos is best, but the 
combination of home and the four cursor motion functions (up, down, 
left, and right) will work also. 


The video_info entry for the Honeywell VIP 7801 is: 
video _info: 


screen line length: 80; 
screen height: 


24; 
home: ESC H; 
clear_to_eos: ESC J, pad i; 
cursor up: ESC A; 
cursor right: ESC C; 
cursor down: LF; 
cursor left: BS3 
clear_to_eol: ESC K; 
insert_chars: ESC *"{I"; 
end_insert_chars: ESC "CJ"; 
delete chars: ESC "CPs 
insert lines: ESC: Ci" 
delete lines: hoc: “iM 
abs_pos: ESE 2° ae" oN) CY a. Oh Ds 


Global Statements 


A global statement specifies a default value for a terminal type attribute. 
It has the same form as the statement describing the attribute in a terminal 
type entry, except that the statement keyword begins with a capital letter. 
Global statements may not appear within terminal type entries. Global statements 
may be used for any of the statements listed above for a terminal type entry, 
except for terminal type, initial string, additional info, and the delay statements. 
(A global Bauds, Bps, or Cps statement is allowed, although a global delay 
statement is not.) A global video table definition may be given by using the 
statement: 


Video info: 
followed by one or more video table entries. The statement: 
Video_info: ; 


may be used to specify that no default video table exists. 
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Conversion Table Entry 


A eonversion table entry consists of two statements: one specifying the 
name of the table and one specifying its contents. The following is a description 
of a conversion table entry. 


conversion table: <table name>; 

<valueO> <valuel1> ... <value255>; 
The table name is a string of up to 32 characters. The values are octal 
numbers of one to three digits; each value is the indicator corresponding 
to the character whose ASCII value is the index of the indicator in the 
table. See the descriptions of the set_input_conversion and 
set_output_conversion orders to the tty _ I/0 module for a description of 
conversion tables and the indicators they contain. If fewer than 256 values 
are supplied, the unspecified values are assumed to be zero. 


Translation Table Entry 


A translation table entry consists of a statement specifying the name of 
the table and a statement specifying its contents, as described below. 


translation table: <table name>; 

<valueO> <value1> ... <value255>3; 
The table name is a string of up to 32 characters. The values are octal 
numbers of one to three digits. Each value is the result of translation of 
the character whose bit representation is the index into the table of that 
value (i.e., <valueO> is the result of translating a character represented 
as 000, <value8> corresponds to a character represented as 010, etc.). If 
fewer than 256 values are supplied, the unspecified values are assumed to 
be zero. 


Function Key Table Entry 


A funetion key table is begun and named by a function _key table statement, 
which is the only required statement. All the remaining statements define function 
key sequences, and are optional. A function key is defined by giving the name 
of the key, and the characters transmitted when the key is struck. The following 
names are recognized: home, up, down, left, right, and key(i), where i must be 
0 or greater, and is the number of the function key. If the terminal has no 
function key labelled 0, then the first key may be 1. No gaps are permitted, 
but the keys may be defined in any order. 


Up to four sequences may be defined for each key, giving the sequences 
transmitted for the function key, the function key when shifted, the function 
key when the control key is held down, and the function key with both shift and 
eontrol, in that order, separated by commas, and terminated by a semi-colon. If 
less than four sequences are given, or a sequence is missing, the terminal is 
assumed to not have a function key for that combination of key-strokes. 


If the terminal always takes some local action (e.g. clearing the screen, 
moving the cursor) (possibly in addition to transmitting the sequence) when a 
key is struck, it is better to omit the sequence entirely, since most applications 
will not want the side-effect to occur, and would most likely not even use the 
key- 


3-15 CC92-01 


Example 


function key table: vip 7801 function keys; 
home: ESC H;3 
Letts BSC D3 
rights BSC C3 
up: ESC A$; 
down: ESC B; 


key(0): ESC e, ESC ~*~, ESC e; 


3 ’ 
key (1): ESC 0, ESC 1; 
key (2): ESC 2, ESC 5; 
key (3): ESC 6, ESC 7; 
key (4): ESC 8, ESC 9; 
key C5) ® ESC -*,. BSc. ts" 
key (6): ESC <, ESC 53 
key (7): ESC >, ESC ?3 
key (8): ESC P, ESC Q; 
key (9): ESC R, ESC S; 
key (10): ESC T, ESC V;3 
key (11): ESC \, ESC ];3 
key (12): ESC “, ESC 3 


Special Characters Table Entry 


A special characters table entry consists of a special table statement and 
a set of statements specifying the contents of a special characters table. 
These statements are described below. Wherever the expression <sequence> appears, 
it means from zero to three <tty char>s, separated by white space, representing 
a sequence of characters to be output to fulfill the specified function. If any 
statement specifying a sequence is omitted, a null sequence is assumed, unless 
otherwise specified in the description of the statement. All sequences are in 
ASCII code except for the printer _onand printer off sequences. For those sequences 
that are used when specific indicators are encountered in the output conversion 
table, the relevant indicator is given in the description of the statement. See 
the description of the various tables in the discussion of orders to the tty 
I/O module for more detailed information. ~ 


special table: <table name>; 
The special table statement specifies the name of the table. It is a string 
of up to 32 characters. 


new line: <sequence>; 
The new_line statement specifies the sequence to be output for a newline 
character (output conversion indicator 1). 


carriage return: <sequenced; 
The carriage return statement specifies the sequence to be output for a 
carriage return character (output conversion indicator 2). If the sequence 
is null, backspaces are used to move the carriage to the left margin. 


3-16 CC92-01 


backspace: <sequence>; 
The backspace statement specifies the sequence to be output for a backspace 
character (output conversion indicator 4). If the sequence is null, a carriage 
return and spaces are used to reach the correct column. The carriage return 
and backspace sequences should not both be null. 


tab: <sequence>; 
The tab statement specifies the sequence to be output for a horizontal tab 
character. If the sequence is null, an appropriate number of spaces is 
used to reach the next tab stop. 


vertical tab: <sequence>; 
The vertical tab statement specifies the sequence to be output for a vertical 
tab character (output conversion indicator 5) if the terminal is in vertsp 
mode. 


form feed: <sequence>; 
~The form feed statement specifies the sequence to be output for a formfeed 
character (output conversion indicator 6) if the terminal is in vertsp 
mode. 


printer_on: <sequence>; 
The printer_on statement specifies the sequence to be output to fulfill a 
"printer_on" order. The sequence is specified in the character code of the 
terminal. If the sequence is null, the printer_on feature is not supported. 


printer off: <sequence>; 
The printer_off statement specifies the sequence to be output to fulfill a 
"printer off" order. The sequence is specified in the character code of 
the terminal. If the sequence is null, the printer off feature is not 
supported. 7 


red shift: <sequence>; 
The! red shift statement specifies the sequence to be output for a 
red-ribbon-shift character (output conversion indicator 10 (octal)). 


black shift: <sequence>; 
The black shift statement specifies the sequence to be output for a 
black-ribbon-shift character (output conversion indicator 11 (octal)). 


end of page: <sequence>; 
The end of page statement specifies the sequence to be output when output 
is suspended because the page length of the terminal has been reached. If 
it is omitted, the character sequence "EOP" is assumed. A null string 
indicates that output is to stop at the right margin of the last line of a 


page. 


output_escapes: <indicator1> <sequencel>, 

<indicator2> <sequence2>, ... <indicatorN> <sequenceN>; 
The output_escapes statement specifies the escape sequences to be output 
for characters whose output conversion indicators are 21 (octal) or greater 
when the terminal is in “edited mode. The indicators specified in the 
statement are the same as the corresponding indicators in the output conversion 
table. 


edited _output_escapes: <indicator1> <sequence 1>, 

<indicator2> <sequence2>, ... <indicatorN> <sequenceN>; 
The edited _output_escapes statement specifies sequences like those specified 
by the output escapes statement, but they are used when the terminal is in 
edited mode. 
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input_escapes: <valuel> <result1>, 

<value2> <result2>, ... <valueN> <resultN>; 
The input_escapes statement specifies those input characters that are to be 
interpreted as escape sequences when preceded by an escape character, and 
the resulting characters that replace those sequences. (An escape character 
in this context is a character defined by software to initiate an escape 
sequence, i.e., one with an indicator of 2 in the input conversion table.) 
Each "value" is an octal number representing the ASCII value of a character 
that is used in an escape sequence; the corresponding "result" is an octal 
number representing the single character that replaces the escape sequence 
in the input stream. 


Default Types 


Exactly one default types statement must appear in the TTF. It specifies 
default terminal types on the basis of baud rate and line type. When a terminal 
dials up, this information is used by the answering service to assign its type 
if no default terminal type is specified in the CDT entry for the channel. The 


default_types statement is described below. 


default_types: <baud1> <line typei> <terminal _typel>, 

<baud2> <line _type2> <terminal _type2>, ... 

<baudN> <line _typeN> <terminal _typeN>; 
Each baudi is a number representing a baud rate, or the word "any"; each 
line _typei is the name of a valid line type, or the word "any"; each 
terminal _typei is the default terminal type for the specified combination 
of baud rate and line type. The table thus constructed is searched in the 
order in which the baud rate, line type, terminal type triplets are specified, 
and the first entry that matches the particular channel is used to determine 
the initial terminal type. The last entry in the table should specify 
"any" for both baud rate and line type. 


Answerback Table 


The answerback table consists of entries specifying how to determine a 
terminal type and identification on the basis of its answerback. The answerback 
sent by the terminal is scanned under control of each answerback table entry, 
starting with the first one specified in the answerback table. If the sean 
succeeds (as described below), and the line type of the terminal is one that is 
valid for the terminal type specified in the answerback table entry, the terminal 
type and ID are derived from that entry; otherwise, the answerback is rescanned 
using the next entry, and so on. An answerback table entry consists of two 
statements: an answerback statement and a type statement. 


answerback: <keyword1> <valuel>, <keyword2> <value2>, ... <keywordN> <valueN>; 
The answerback statement describes how the scan of the answerback is to be 
performed. The "sean pointer," indicating the current character position 
in the answerback of the scan, starts at the beginning of the answerback 
string and is adjusted according to the controls specified by the answerback 
statement. The possible keyword-value pairs are described below. 


match <expression> 

<expression> is either the word "digit," the word "letter," or a 
string enclosed in quotes. If it is digit or letter, the scan fails 
unless the character addressed by the scan pointer is a digit (0 to 
9) or a letter (A to Zor ato z), respectively. If it is a quoted 
string, the scan fails unless the scan pointer points to the beginning 
of a matching string. If the match succeeds, the scan pointer is 
advanced over the matching string or character, and the sean is 
continued using the next keyword-value pair. 
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search <expression> 
works like match, except that the scan succeeds if the matching 
character or string is found anywhere to the right of the scan pointer. 


skip N 
causes the scan pointer to be moved N characters to the right. The 
value N may be negative, in which case the pointer is actually moved 
to the left. The scan fails if there are fewer than N characters 
between the scan pointer and the end (or beginning if N is negative) 
of the answerback string. 


id N 
the N characters starting at the right of the scan pointer form the 
ID of the terminal. The value N must be in the range 1 <= N <= 4. 
If there are fewer than N characters to the right of the scan pointer, 
the sean fails. 

id rest 


as many characters (up to 4) as remain to the right of the scan 
pointer constitute the ID of the terminal (not including control and 
carriage-motion characters). 


type: <type name>; 
The type statement specifies the name of the terminal type to be assigned 
to a terminal whose answerback satisfies the specification in the answerback 
statement. The specified terminal type must be defined by a previous terminal 
type entry. If the type statement is omitted, the answerback is to be used 
to set the ID only, and the terminal type is not changed. 


Preaccess Commands 


The preaccess command entries are used to define the terminal types to be 
set in response to preaccess commands at dialup time. Each preaccess command 
entry consists of a preaccess command statement and a type statement. See the 
MPM Commands for more information about preaccess commands. 


preaccess command: <command>; 
The preaccess command statement specifies the name of a preaccess command. 
The three commands currently supported are MAP, 963, and 029. If a preaccess 
command statement is not present for any one of these command statements, 
the command statement has no effect when entered from the terminal. 


type: <type name>; 
The type statement specifies the terminal type to be assigned when the 
corresponding command is entered. The specified type must be defined by a 
previous terminal type entry. 
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Examples 
/* Sample terminal type entries */ 
Input_conversion: standard_input_conv; 


terminal type: 1050; 
modes: default,hndlquit,tabs,red,111303 


bauds: 133% 
vert nl delays: - 
horz nl_ delays: ails 
const_tab_delays: 1S 
var_tab_ delays ~23 


input_translation: ebcdic_input_trans; 
output_translation: ebcdic_output_trans; 
output_conversion: ebcdic_output_conv; 
special: ebcdic special; 

line types: 1050; 

old_ type: Is 


terminal type: 2741 like 1050; 

modes: default,hndlquit,tabs,red,11125; 
conditional printer off: yes; 

print _preaccess message: yes; 

line types: 2741; 

old_ type: 2; 


terminal type: T1TN300; 
modes: default,hndlquit,tabs,11118; 
initial string: ESC "2" CR ESC "1" (11) < (10) (SP) ESC "1"; 


bauds: 110 150 300 12003 
vert_nl_ delays: 0 2 6 -38; 
backspace delays: -2 -3 -6 -273 
vt_ff_delays: 19 29 59 = 230; 


output conversion: ascii_output_conv; 
special: tn300 special; 

line types: ASCII, 202ETX; 

old type: 4; 


/* sample default_types statement and answerback entries */ 


default types: 

~ 110 ASCII TTY33, 

any ASCII ASCII, 

any VIP ASCII, 

133 1050 1050; 

133 2741 2741, 

1200 ARDS ARDS, 

1200 202ETX TN300, 

any any Gils; 
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/*® the match below sets the terminal type to 1050 if the line type is 1050 ¥*/ 


answerback: 
type: 


answerback: 
type: 


answerback: 
type: 


answerback: 
type: 


answerback: 
type: 


/* sample conversion, translation, and special tables */ 


conversion ta 


bles: 


03 00 00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


translation t 
o40 
064 
062 
066 
061 
065 
063 
067 
O40 
072 
O74 
O47 
075 
O45 
073 
076 


special table 
new line: 0 
carriage ret 
backspace: 
tab: 113 
vertical tab 
form feed: 


00 01 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 


able: 
055 
155 
153 
157 
152 


120 


id. 13 
1050; 


search "0", 


27413 


search "0" 
2741; 


search " E 
TN3003 


search " E 
TN300; 


e 
3 


", id 3; 


le 
’ 


id 3; 


standard input_conv; 


00 
00 
00 
05 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
O4 
00 
00 
00 
00 
00 
00 
00 
00 
00 
02 
00 
00 
00 
00 


00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 


00 
00 


00 
03; 


ebcdic input trans; 


100 
165 
163 
167 
057 
166 
164 
170 
134 
125 
123 
127 
O77 
126 
124 
130 


O46 
144 
142 
146 
144 
145 
143 
147 
053 
104 
102 
106 
101 
105 
103 
107 


070 
000 
060 
000 
071 
000 
043 
000 
052 
000 
051 
000 
050 
000 
O42 
000 


161 
000 
000 
010 
162 
012 
O44 
000 
121 
000 
000 
010 
122 
012 
041 
000 


: ebedic special; 


123 
urn: 
103 


? 


i a 
000 
000 
000 
172 
000 
054 
000 
131 
000 
000 
000 
132 
000 
174 
000 


150 
000 
000 
000 
151 
011 
056 
000 
110 
000 
000 
000 
111 
011 
136 
000; 
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printer on: 15; 
printer off: 16; 


red shift: 033 141; 
black shift: 033 142; 
end_of page: 105 117 120; 


output escapes: 
21 134 O74, 
22 134 076, 
23 134 O47, 
24 134 050, 
25 134 051, 
26 134 164; 


edited_output escapes: 
21 050 070 075, 
22 051 010 075, 
23 O47, . 
24 050 010 055, 
25 051 010 055, 
26 O47 010 136; 


Input_escapes: 
O74 ; 
076 135, 
O47 140, 
050 173, 
O51 175, 
164 176, 
124 1763 


end; 
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SECTION 4 


COMMANDS 


This section contains descriptions of commands used for communications I/O. { 


The conventions shown in the usage lines of these commands are the same as 
those used throughout the set of Multics manuals; briefly, arguments enclosed in 
braces ({}) are optional, and all others are required (unless otherwise noted). 
For a complete description of all the usage line conventions, refer to Section 3 
of the MPM Commands. 
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ev_ttf ev_ttf 


Name: ev_ttf 


The ev_ttf command compiles a terminal type file (TTF) into a terminal type 
table (TTT), in preparation for installing it. 


Usage 


ev_ttf path {-control_arg} 


where: 
1. path 
is the pathname of the TTF to be compiled. The TIT that results 
from the compilation is placed in the user's working directory; its 
entryname is the same as the entryname of the TIF with the suffix 
ttt added. 
2. control _ arg 
may be either of the following: 
-long, -1g 
specifies that all error messages produced by cv_ttf are to be printed 
in long form. 
-brief, -bf 
specifies that all error messages produced by cv_ttf are to be printed 
in short form. 
Notes 


If neither -long nor -brief is specified, the first instance of a given 
error produces a long message, and all subsequent instances of that error produce 
short messages. 
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dial out dial out 


Name: dial out 


The dial out command enables a user to access a remote system by dialing a 
specified destination over a dial-out channel (i.e., a channel that has been 
configured with the autocall service type, as specified in the service statement 
of the CMF). 


Usage 


dial out channel {destination} {-control_ args} 
where: 


1. channel 
the name of the dial-out channel to be used. The star convention is 
allowed, which means the answering service selects a channel that 
has a matching name and matching attributes (if specified). 


2 destination 
is the dial-out destination (e.g., phone number or network address) 
to be used in making the connection. If this argument is omitted, a 
channel is attached as described under dial manager $privileged attach 
in the MPM Subsystem Writers' Guide. - a 


This argument can be up to 32 characters in length and can include 
dial-tone-wait characters, which suspend dialing until the autocall 
unit receives a dial tone. The standard FNP multiplexer recognizes 
the exclamation point ("!") as the dial-tone-wait character and pauses 
at each one encountered to await a dial tone. 


oe control args 
may be chosen from the following: 


-raw 
Suppresses Mulitics terminal management and makes the dial out interface 
completely transparent. Characters are transmitted directly to or 
from the foreign system, without any conversion or processing. 

-echo 
causes characters entered by the user to be echoed locally. 

-line 


causes the communications line to transmit line-at-a-time rather than 
character-at-a-time. This permits the dialing of an FNP channel 
that cannot be run at line speed in character mode. 


-escape STR, -ese STR 
sets the escape character to STR. The escape character enables the 
user to enter dial out requests from within the dial out environment. 
The default escape character is the exclamation point ("!"), 


-terminal type STR, -ttp STR 


sets the terminal type of the remote connection to STR. This argument 
is useful in those cases where the host has unusual communications 
requirements. 
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dial_ 


out dial out 


-resource STR, rse STR 
Specifies the desired characteristics of the dial-out channel. STR 
(which can be null) consists of reservation attributes separated by 
commas. The channel used by a dial out operation must have the 
characteristics specified in the reservation string. Reservation 
attributes consist of a keyword and optional argument. Attributes 
allowed are: 


baud rate=BAUD RATE 
line _type=LINE TYPE 


where BAUD RATE is a decimal representation of the desired channel 
line speed and LINE TYPE is a valid iine type, chosen from 
line types.incl.pl1 (see set line type, in Section 6). 


-abbrev 
enables the user to invoke abbrev processing of request lines. 


-profile PATH 
defines the pathname PATH of the profile segment that contains abbrevs 
used with the dial out command. The suffix .profile is assumed if 
it is not present. The default is the user's current profile segment. 


-request STR 
Causes the dial out command to execute the request STR after the 
connection is established, but before entering the dial out environment. 


Notes 


The user may enter dial out requests from within the dial out environment 


by preceding requests with the escape character ("!" by default). Typed entries 
between one escape character and the next or the end of the line are interpreted 
as the dial out request. The escape character itself may be sent by entering it 
twice in succession. 


Use of the dial out command requires the dialok attribute and rw access to 


>sc1>rep>NAME.acs. 


List 


£182 


of Requests 


escape STR, ese STR 
sets the escape character to STR. 


file output PATH, fo PATH 
“copies output to a file identified by the pathname PATH. 


interrupt, int, break, brk, ip 
sends an interrupt signal (line break) to the foreign system. 


modes {raw;“raw}, {echo} “*echo} 


allows the user to enable or disable the raw and echo modes (as described 
under the -raw and -echo control arguments). 
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dial out 


dial_out 


revert output, ro 
reverts the effect of the previous file output request; i.e., causes 
output to no longer be copied to the file identified by the file output 
request. 


send 


causes arguments within the request to be sent to the foreign system 
as if they were typed by the user. 


send file PATH, sf PATH 
“causes the contents of pathname PATH to be sent to the foreign system. 


Switch name 
returns the name of the I/O switch used by the dial out interface. 


Examples 


The dial out command 


dial out b.h218 9-555-5622 -raw 
Ready on tty  b.h218 -destination 9-555-5622 


attaches channel b.h218 to the dial destination 9-555-5622, while suppressing 
Multics terminal management. The ready message is printed by the system, verifying 
the connection. 


The dial out command 


dial out b.h000.1.* 31060849 


establishes a network connection over an appropriate channel (i.e., one that 
meets the star convention requirements) at address 31060849. 
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display ttt display ttt 


Name: display ttt 


The display ttt command prints all or part of a terminal type table (TTT) 
on the user's terminal, or outputs it to a file. The format of the output is 
such that it can be used as a terminal type file (TTF). 


Usage 
display_ttt {-econtrol_args} 


where control_args may be chosen from the following list: 


-pathname path, -pn path 
specifies that the TIT whose pathname is path is to be displayed. 
If this control argument is omitted, the process' current TTT is 
displayed. 


-terminal type name, -ttp name 
specifies that only the terminal type entry for the terminal type 
named name is to be displayed (see "Notes" below). 


-table name, -tb name 
specifies that only the conversion, translation, function keys, or 
special table named name is to be displayed (see "Notes" below). 


-output_file path, -of path 
specifies that output is to be directed to the file whose pathname 
is path. If this control argument is omitted, output is directed to 
the terminal. 


-header, -he 
specifies that a header is to be printed (see "Notes" below). 


-no header, -nhe 
specifies that no header is to be printed (see "Notes" below). 


Notes 


If neither -terminal_type nor -table is specified, the entire contents of 
the TTT are displayed; if -no_header also is not specified, an introductory 
comment is printed, giving the pathname of the TIT, the date, and the user id of 
the author of the original TIT. If either -terminal_ type or -table is specified, 
only the specified terminal type entry or table is displayed, without the introductory 
comment unless -header is also specified. 
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The 16 ftf command allows a process to handle file transfer requests from a 
Level 6, using the L6 File Transfer Facility (FIF) protocol (referred to as 
L6 TRAN; see Level 6/Level 6 File Transmission Facility User's Guide CB33). This 
command continues to listen for and carry out Level 6 requests until the user 
explicitly tells it to stop. Only sequential ASCII or sequential binary files 
may be transferred to or from the Level 6. ASCII files on Multics are assumed 
to be stream files when sending, and are stored as stream files when receiving. 
Binary files on Multics have a special format (see Notes below). 


Usage 


16 ftf channel_name {control args} 


wheres: 
1. channel name 
is the name of a polled VIP subchannel over which the file transfers 
will take place. It must have the "x" prefix. (See Notes below). 
2% control arg 
may be either of the following: 
-long, -lg 
prints a line describing each file transfer as it starts and as it 
is completed. The default is not to print this information. 
-target dir PATH, -td PATH 
specifies that the pathnames of any files to be transferred are 
relative to the target directory. The root may be specified as ">", 
which allows absolute pathnames to be specified. The default is the 
working directory. 
Notes 


This command continues to listen for and process file transfer requests 
from the Level 6 on the specified channel until the Multics user types "q" or 
"quit" or the channel disconnects. The quit request may be typed at any time, 
but will only take effect before any file transfer has started or between two 
file transfers. 


The user must have rw access to the ACS of the specified channel name to 
use the file transfer facility. The user must have the "dialok" attribute turned 
on in the PDT. The polled VIP subchannel must have the slave attribute in the 
CDT, and must be an "X" type subchannel (see the description of polled VIP 
multiplexers in MAM Communications.) 
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Interrupting and releasing a file transfer in the middle of the transfer 
may result in aborting the operation in an inconsistent state, and causing the 
Level 6 task to hang.. 


The Polled VIP multiplexer must have a terminal type (in the TTF) which 
sets the "additional_info" parameter to "max _ message _len=1009 omit_nil=yes 
omit ffsyes". (See the description of polled VIP multiplexers in MAM 
Communications). 


Only sequential ASCII or sequential binary files may be transferred from or 
created on the Level 6. On Multies, ASCII files are assumed to be or are 
created as stream files. Notice that blank lines in a Level 6 file actually 
have some character on them, usually a space or tab. These characters will end 
up in the Multics file. The command sends blank lines from Multics files to the 
Level 6 by sending a line containing a single space character. 


On Multies, binary files are sequential vfiles. Each record is assumed to 
have the following format: 
del 1 binary_record aligned based, 
2 num_sextets fixed bin(35) aligned, 
2 sextets (0 refer binary _record.num_sextets) fixed bin(6) 


unsigned unaligned; 


Each binary record is stored in a vfile_ record of size 
currentsize(binary_record) * 4. 


Examples j 


The following Level 6 command: 
TRAN ISD -L6 -N >SPD>PVEO1 -ISA TEST -ASA FOO 
sends the Level 6 file TEST to the Multics segment FOO assuming the 16 ftf 


command has specified the PVE subchannel name corresponding to >SPD>PVEO1 on the 
Level 6. See CB33 for more information (this is a Level 6 manual). 
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Name: print_terminal types, ptt 


The print terminal types command prints the names of all terminal types 
defined in the terminal type table (TTT) currently in use. If the TIT in use is 
not the system default TIT, the command prints the current TIT's pathname at the 
head of the list of terminal names. 


Usage 
print_terminal_types {path} 


where path specifies the pathname of the TTT. If omitted, the current TTT is 
used. 


4-6 CC92-01 


print _ttt_path print _ttt_path 


Name: print_ttt_path 


This command prints the name of the terminal type table (TTT) segment currently 
in use. This is the pathname last set by a set_ttt_path command, or the pathname 
of the default system TTT. 


Usage 


print _ttt_path 


No arguments are required. 
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Name: set _ttt_path 


The set_ttt_path command changes the 
(TTT) associated with the user's process. 


Usage 


set_ttt_path ipath} t-control_arg} 


set_ttt_path 


pathname of the terminal ‘type table 


If no path argument is given, then 


can be -reset (-rs) to reset the TTT pathname to its default value 


where: 
1. path 
is the pathname of the TTT. 
control_arg is required. 
2. control arg 
of >system_control_1>ttt. 
Notes 


The use of path argument and the -reset control argument are mutually exclusive; 
only one may be given in any invocation of the set_ttt_path command. 
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Name: set _tty, stty 


The set_tty command modifies the terminal type associated with the user's 
terminal and/or various parameters associated with terminal I/O. The type as 
specified by this command determines character conversion and delay timings; it 
has no effect on communications line control. 


Usage 
set_tty {-control_args} 


where control _ args may be chosen from the following control arguments: 


-all, -a 
is the equivalent of specifying the four control arguments -print, 
-print_edit, -print_frame, and -print_delay. 


-buffer size N, -bsize N 
specifies the terminal's buffer size to be used for output block 
acknowledgement (see the discussion of output flow control in Section 
2). Nis the terminal's buffer size in characters. If the end_of block 
and acknowledgement characters have not been specified (either as 
part of the terminal type description or by means of the -output_etb_ack 
control argument to set _ tty), this control argument may not be specified. 


-brief, -bf 
may only be used with the -print control argument and causes only 
those modes that are on plus those that are not on/off type modes 
(e.g., 1179) to be printed. 


-delay STR, -dly STR 
sets the delay timings for the terminal according to STR, which is 
either the word "default" or a string of six decimal values separated 
by commas. If "defauit" is specified, the defauit values for the 
current terminal type and baud rate are used. The values specify 
vert _nl, horz_nl, const_tab, var_tab, backspace, and vt_ff, in that 
order. The méanings of the "values are as follows: 


vert_nl 
“is the number of delay characters to be output for all newlines 
to allow for the linefeed (-127 < vert_nl < 127). If it is 
negative, its absolute value is the minimum number of characters 
that must be transmitted between two linefeeds (for a device 
such as a TermiNet 1200). 


horz nl 
“is a number to be multiplied by the column position to obtain 
the number of delays to be added for the carriage return portion 
of a newline (0 < horz nl < 1). The formula for calcuiating 
the number of delay characters to be output following a newline 
is: 


ndelays = vert_nl + fixed (horz_n1*column) 
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const_tab 
is the constant portion of the number of delays associated with 
any horizontal tab character (0 < const_tab < 127). 


var_tab 
is the number of additional delays associated with a horizontal 
tab for each column traversed (0 < var tab < 1). The formula 
for calculating the number of delays to be output following a 
horizontal tab is: 


ndelays = const_tab + fixed (var_tab*n_ columns) 


backspace 

is the number of delays to be output following a backspace 
character (-127 < backspace < 127). If it is negative, its 
absolute value is the number of delays to be output with the 
first backspace of a series only (or a single backspace). This 
is for terminals such as the TermiNet 300 that need delays to 
allow for hammer recovery in case of overstrikes, but do not 
require delays for the carriage motion associated with the 
backspace itself. 


Vt ff 
~ igs the number of delays to be output following a vertical tab 
or formfeed (0 < vt_ff < 511). 


The horz_nl and var_tab values are floating-point numbers; all other 
values are integers. If any of the six values is omitted, the 
corresponding delay value is not changed; if values are omitted from 
the end of the list, trailing commas are not required. 


-edit edit chars, -ed edit_chars 


-frame 


changes the input editing characters to those specified by edit_chars. 
The edit chars control argument is a 2-character string consisting 
of the erase character and the kill character, in that order. If 
the erase character is specified as a blank, the erase character is 
not changed; if the kill character is omitted or specified as a 
blank, the kill character is not changed. 


STR, -fr STR 

changes the framing characters used in blk xfer mode to those specified 
by STR, where STR is a 2-character string consisting of the frame-begin 
and the frame-end character, respectively. These characters must be 
specified in the character code of the terminal, and may be entered 
as octal escapes, if necessary. The frame-begin character is specified 
as a NUL character to indicate that there is no frame-begin character; 
the same is true for a frame-end character. These characters have 
no effect unless blik_xfer mode is on. It is an error to set the 
frame-end character to NUL if the frame-begin character is not also 
set to NUL. 


-initial string, -istr 


transmits the initial string defined for the terminal type to the 
terminal. 
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7/82 


-input_ 


Set tty 


flow control STR, -ife STR 

sets the input | suspend and input resume characters to those specified 
in STR, which is a string of one or two characters. (See the discussion 
of input flow control in Section 2.) If STR contains two characters, 
the first character is the input suspend character and the second 
one is the input resume character. If STR contains only one character, 
it is the input resume character and there is no input_suspend character. 


~io_ switch STR, -is STR 


-modes 


specifies that the command be applied to the I/O switch whose name 
is STR. If this control argument is omitted, the user i/o switch is 
assumed. _ 


STR, -md STR 

sets the modes for terminal I/O according to STR, which is a string 
of mode names, each separated by a single comma. Many modes can be 
optionally preceded by "*" to turn the specified mode off. For a 
list of valid mode names, see the description of the tty I/0 module. 
Modes not specified in STR are left unchanged. See "Notes" below. 


-output etb ack STR, -oea STR 


sets the output _ end of block and output acknowledge characters to 
those specified in STR, which is a string of two characters. (See 
the discussion of output flow control in Section 2.) The first 
character of STR is the end of block character and the second one is 
the acknowledge character. If a buffer size has not been specified 
(either as part of the terminal type description or by means of the 
-buffer size control argument to set tty), this control argument may 
not be specified. 


-output suspend resume STR, -osr STR 


-print, 


-print 


sets the output suspend and output resume characters to those specified 
in STR, which is a string of two characters. (See the discussion of 
output flow control in Section 2.) The first character of STR is 
the output suspend character and the second is the output resume 
character. | = 


-pr 

prints the terminal type and modes on the terminal. If any other 
control arguments are specified, the type and modes printed reflect 
the result of the command. 


delay, -pr dly 


“prints the delay timings for the terminal. 


-print edit, -pr ed 


-print 


“prints the input-editing characters for the terminal. 


frame, -pr fr 


“prints the framing characters for the terminal. 
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-reset, -rs 


sets the modes to the default modes string for the current terminal 
type. 


-terminal type STR, -ttp STR 


Notes 


sets the terminal type of the user to STR, where STR can be any one 
of the types defined in the terminal type table (TTT). The default 
modes for the new terminal type are turned on and the initial string 
for the terminal type, if any, is transmitted to the terminal. 
Refer to the print_terminal_types command for information on obtaining 
a list of terminal types currently in the TTT. 


Invoking the set_tty command causes the system to perform the following 
steps in the specified order: 


1. 


11. 


12. 


13. 


If the -terminal_type control argument is specified, set the specified 
type, turn on the default modes for that type and send the initial 
string for that type. 


If the -reset control argument is specified, set the modes to the 
default modes string for the current terminal type. 


If the -modes control argument is specified, turn on or off those 
modes explicitly specified. 


If the -initial_ string control argument is specified, transmit the 
initial string to the terminal. 


If the -edit control argument is specified, set the editing characters. 
If the -frame control argument is specified, set the framing characters. 
If the -delay control argument is specified, set the delay values. 


If the -input_flow_control control argument is specified, set the input 
flow control characters. 


If the -buffer_size, -output_etb_ack, or -output_suspend_resume control 
argument is specified, set the corresponding output flow control 
parameters. 


If the -print control argument is specified, print the type and modes 
on the terminal. 


If the -print_edit control argument is specified, print the editing 
characters on the terminal. 


If the -print_ frame control argument is specified, print the framing 
characters on the terminal. 


If the -print_delay control argument is specified, print the delay 
values on the terminal. 
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Examples 


The command line: 
set _tty -delay 6,0,0,0,-6,59 


sets all six delay values to those used by a TermiNet 300. 


The command line: 

set_tty -delay 5,0.6,,,2,63 
sets the delay values so that 5 delays will be output with a newline, plus 3 
more for every 5 columns of carriage return; 2 delays will be used for each 
backspace, 63 for a vertical tab or formfeed, and whatever values were already 
in force for horizontal tabs. 

The command line: 

set_tty -delay ,1.3,,.8 
sets horz_nl to 1.3 and var_tab to 0.8, while leaving all other delay values as 
they were before. 

The command line: 


set_tty -frame \002\003 


sets the frame-begin and frame-end characters to the ASCII STX and ETX characters, 
respectively. 
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SECTION 5 


SUBROUTINES 


This section describes the ttt_info_ subroutine, which extracts information 
about a terminal type from the terminal type table. 


The conventions shown in the usage lines of this subroutine are the same as 
those used in the MPM Subroutines; briefly, the usage lines first show the 
proper format to use when declaring the subroutine, and then show a sample call. 
For a complete description of all the usage line conventions, refer to Section 2 
of the MPM Subroutines. 
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Name: ttt_info_ 


The ttt _info_ subroutine extracts information from the terminal type table 
(TTT). 


Entry: ttt_info_$terminal_ data 


This entry point returns a collection of information that describes a specified 
terminal type. 


Usage 


declare ttt_info $terminal_ data entry (char(*), fixed bin, fixed bin, ptr, 
fixed bin(35)); 


call ttt_info_$terminal_data (tt_name, line _type, baud, ttd_ptr, code); 


where: 

ie tt_name (Input ) 
is the terminal type name. 

Ps line type (Input) 
is a line type number against which the compatibility of the terminal 
type is verified. If nonpositive, the line type number is ignored. 
For further description, see the tty_ I/0 module in Section 6. 

35 baud (Input) 
is a baud rate used to select the appropriate delay table. 

4. =ttd_ptr (Input ) 
is a pointer to a structure in which information is returned. (See 
"Notes" below.) 

os code (Output ) 
is a standard status code. If the terminal type is incompatible 
with the line type, a value of error _table $incompatible term_type 
is returned. 

Notes 


The ttd_ptr argument should point to the following structure 
(terminal type _data.incl.pl1): 


del 1 terminal type data aligned, 
2 version : fixed bin, 
2 old_type fixed bin, 
2 name char(32) unaligned, 
2 tables, 
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3 input _tr_ptr ptr, 
3 output _tr_ptr ptr, 
3 input_cev_ptr ptr, 
3 output _ecv_ptr ptr, 
3 special ptr ptr, 
3 delay ptr pers 


2 editing chars 
3 erase char(1) 
3 kill char(1) 


unaligned, 


unaligned, 
unaligned, 


ttt_info_ 


2 framing chars unaligned, 
3 frame_begin char(1) unaligned, 
3 frame end char(1) unaligned, 
2 flags, unaligned, 
3 keyboard_locking bie); 
3 input_timeout bit(1), 
3 output_block_ acknowledge  bit(1), 
3 mbz bit(15), 
2 line delimiter char(1) unaligned, 
2 mbz bit(9) unaligned, 
2 flow_control_ chars unaligned, 
3 input_suspend char(1), 
3 input_resume ehar(1), 
3 output _suspend_etb char(1), 
3 output resume ack ehar(1), 
2 output_buffer_size fixed bin; 
where: 
Tie version (Input) 
is the version number of the above structure. It must be 1 or 2. 
2. old_type (Out put ) 
is the old terminal type number that corresponds to the terminal 
type name. (The old terminal type number is provided only for 
compatibility with the obsolete tty order requests set_type and 
info.) A value of -1 indicates that no corresponding old type exists. 
3. name (Output ) 
is the terminal type name. 
Be input.tr: ptr (Out put ) 


output_tr_ptr 


input_cv_ptr 


is a pointer to a structure containing the input translation table. 
This structure is identical to the info structure for’ the 
set_input_translation order of the tty_ I/O module. 


(Out put ) 

is a pointer to a structure containing the output translation table. 
This structure is identical to the info structure for the 
set_output_translation order of the tty_ I/0 module. 


(Output ) 

is a pointer to a structure containing the input conversion table. 
This structure is identical to the info structure for the 
set_input_conversion order of the tty_ I/O module. 
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12. 


13. 


14. 


15. 


16. 


17. 


Tes 


19. 


20. 


21.6 


226 


output _ev_ptr (Out put ) 
is a pointer to a structure containing the output conversion table. 
This structure is identical to the info structure for the 
set _output_conversion order of the tty _ I/O module. 


special ptr (Out put ) 
is a pointer to a structure containing the special characters table. 
This structure is identical to the info structure for the set special 
order of the tty_ I/O module. = 


delay ptr (Output ) 
is a pointer to a structure containing the delay table. This structure 
is identical to the info structure for the set_delay order of the 
tty _ I/O module. 


erase (Out put ) 
is the erase character. 


kill (Out put ) 
is the kill character. 
frame begin (Output ) 
is the frame-begin character. 
frame_end (Out put ) 
is the frame-end character. 
keyboard_locking (Out put ) 
indicates whether the terminal type requires keyboard locking and 
unlocking. 
Wq4th yes 
"ONMb no 
input_timeout (Output) 
is "1"b if the timeout option was specified on an input_resume statement 
in the TTF. 
output _ block _acknowledge (Output) 


is "1"b if output end of _block and output_acknowledge statements were 
specified in the TTTE 


mbz 
must be "0O"b. 


line delimiter (Output) 
is the line delimiter character. 


flow_control_ chars 
identifies the flow control characters. It is not present if version 
(above) is 1. 


input_suspend (Out put ) 
is the character sent to the terminal to suspend input, or sent by 
the terminal to indicate that it is suspending input. 


input_resume (Output) 
is the character sent to the terminal to resume input. 


out put_suspend_etb (Output ) 


is the character sent by the terminal to suspend output if 
GUC Dut 4 block Lae NOW Sc es ee Coli, otherwise it is the character to 
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23. output_resume ack (Output) 
is the character sent by the terminal to resume output if 
output block acknowledge is "0"b; otherwise it is the character used 
to acknowledge an output block. 


24. output_buffer_size (Output) 
is the size, in characters, of the terminal's buffer, for use with a 
block acknowledgement protocol. It is 0 unless 


output block acknowledge is "i"b. It is not present if version is 
Ts 


Entry: ttt_info $modes 


This entry point returns the default modes for a specified terminal type. 


Usage 


declare ttt_info $modes entry (char(*), char(*), fixed bin(35)); 


call ttt_info_$modes (tt_name, modes, code); 


where: 

1. tt_name (Input) 
is the terminal type name. 

2 modes (Output) 
is the default modes string for the terminal type. If its length is 
less than 256 characters, the entire modes string is not necessarily 
returned. 

3 code (Output) 


is a standard status code. 


Entry: ttt _info $preaccess type 


This entry point returns the terminal type name associated with a specified 
preaccess request. 
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Usage 
declare ttt_info $preaccess type entry (char(*), char(*), fixed bin(35)); 


call ttt_info $preaccess type (request, tt_name, code)); 


where: 
1. request (Input) 
is one of the following three preaccess requests: MAP, 963, or 029. 
2. tt_name (Output) 
is the name of the associated terminal type. Its length should be 
at least 32 characters. 
3 code (Output) 


is a standard status code. 


Entry: ttt_info $additional_info 


This entry point returns additional information for a specified terminal 
type to be used by I/0 modules other than tty. 
Usage 


del ttt_info $additional_ info entry (char(*), char(*) varying, 
fixed bin(35)); 


call ttt_info $additional_ info (tt_name, add_info, code); 


where: 

Vs tt_name (Input) 
is the terminal type name. 

2. add_info (Output) 
is the additional information string. If no additional information 
is defined for the terminal type, a null string is returned. Maximum 
length is 512 characters. 

3. code (Output) 


is a standard status code. 


Entry: ttt_info_$initial_string 


This entry point returns a string that can be used to initialize terminals 
of a specified terminal type. The string must be transmitted to the terminal in 
raw output (rawo) mode. The initial string is most commonly used to set tabs on 
terminals that support tabs set by software. 
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Usage 


declare ttt_info $initial string entry (char(*), char(*) varying, 
fixed bin(35)); 


call ttt_info $initial_ string (tt_name, istr_info, code); 


where: 

1. tt_name (Input) 
is the terminal type name. 

2. istr_info (Output) 
is the initial string. If no initial string is defined for the 
terminal type, a null string is returned. Maximum length is 512 
characters. 

3% code (Output) 


is a standard status code. 


Entry: ttt info $dialup flags 
oor: as Se i 


This entry point returns the values of two flags for a specified terminal 
type. 


Usage 
declare ttt_info $dialup flags entry (char(*)}, bit(i), bit(1), 
fixed bin(35)); 


call ttt_info $dialup flags (tt_name, ppm flag, cpo_ flag, code); 


where: 

1.  tt_name (Input) 
is the terminal type name. 

2. ppm_flag (Output) 
indicates whether a preaccess message should be printed when an 
unrecognizable login line is received from a terminal of the specified 
type: 
"1b yes 
"NOMNb no 

3. epo_ flag (Output) 
indicates whether "conditional printer off" is defined for the terminal 
type, i.e., if the answerback indicates whether a terminal is equipped 
with the printer off feature: 
Ww4th yes 
"ONhH no ‘ 

4, code (Output) 


is a standard status code. 
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Entry: ttt_info_ $decode_ answerback 


This entry point decodes a specified answerback string into a terminal type 
name and terminal identifier. 


Usage 


declare ttt_info $decode answerback entry (char(*), fixed bin, char(*), 
char(*), fixed bin(35)); 


call ttt_info $decode answerback (ansb, line type, tt_name, id, code); 


where: 

As ansb (Input) 
is the answerback string. 

2. line type (Input) 
is a line type number with which the decoded terminal type must be 
compatible. A nonpositive line type number is ignored. For further 
description, see the tty  I/0 module. 

3. tt_name (Output) 
is the terminal type name decoded from the answerback. Its length 
should be at least 32 characters. If no terminal type is indicated, 
a null string is returned. 

4, id (Output) . 
is the terminal identifier decoded from the answerback. Its length 
should be at least four characters. If no id is indicated, a null 
String is returned. 

5. code (Output) 


is a standard status code. 


Entry: ttt_info_ $encode type 


This entry point obtains a code number that corresponds to a specified 
terminal type name. 
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Usage 


declare ttt_info_$encode type entry (char(*), fixed bin, fixed bin(35)); 


call ttt_info_ $encode type (tt_name, type code, code); 


where: 
1. tt_name (Input) 
is the terminal .type name. 
23 type_code (Output) 
is the corresponding terminal type code number. 
3% code (Output) 


is a standard status code. 


Entry: ttt_info $decode type 


This entry point obtains the terminal type name that corresponds to a specified 
terminal type code number. 


Usage 


declare ttt_info_$decode type entry (fixed bin, char(*), fixed bin(35)); 


call ttt_info_$decode type (type_code, tt_name, code); 


where: 
se type_code (Input) 
is the terminal type code number. 
2. tt_name (Output) 
is the corresponding terminal type name. 
3. code (Output) 


is a standard status code. 
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Entry: ttt_info $video info 


This entry point is used to obtain a copy of the video sequences 
table for a particular terminal type. 


Usage 


del ttt_info_ $video_ info entry (char (*), fixed bin, ptr, ptr, fixed bin 


(35))3 
call ttt_info $video info (terminal _type, baud_rate, areap, ttyvtblp, 
rode); 
where: 
le terminal type (Input) 
is the name of the terminal type for which the video table is required. 
2.  baud_rate (Input) 
is the current baud rate of the terminal. This may be set to 0 if 
it is unknown, or uninteresting. 
35 area (Input) 
is a pointer to an area where the video table may be allocated. If 
null, the system free area is used. 
4, ttyvtblp (Output) 


is a pointer to the video table, if present. 


Ba code (Output) 
is a standard system status code. 
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The format of a video table is given in the include file 
tty video tables.incl.pl1. 


del 1 tty video table aligned based (ttyvtblp), 


1 
2 version fixed bin, 
2 screen_height fixed bin, 
2 screen line length fixed bin, 
2 scroll count fixed bin, 
2 flags unaligned, 
3 overstrike available bit (1) unal, 
3 automatic crif bit (1) unal, 
3 simulate _eol — bit (1) unal, 
3 pad bit (33) unaligned, 
2 video chars len fixed binary (21) 
2 pad (2) bin (36) 
2 nseq fixed bin, 
2 sequences (N_VIDEO | SEQUENCES refer (tty video table.nseq) 
like tty_ video seq aligned, 
2 video chars char (tty video table video chars len refer 
a (tty_ video_table.video chars _len)) unal; 
where: 
Tas version 


is the version of this structure. It must be 
tty video tables tables version _1, also declared in this include file. 


2. screen height 
is the number of lines on this terminal. 


3. screen line length 
is the number of character positions (columns 
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4, scroll count 
is the number of lines scrolled upward when a scroll command is sent 
to the terminal (if the terminal is capable of scrolling). For most 
terminals this will be 1. A value of 0 indicates that one line is 
scrolled. 


5s flags 
describe characteristics of the terminal. 


6. overstrike available 
is "1"b if the terminal can overstrike (i.e., more than one character 
can be seen in the same character position). 


ce automatic crif 
is "1"b if the terminal performs a carriage return and line feed 
when a character is displayed in the last column. 


8. pad 
has an undefined value, and is reserved for future expansion 
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g. simulate_eol 
is reserved for future expansion. 
9. pad 


is reserved for future expansion. | 


10. video_chars_ len 
specifies the length of the string containing all video sequences. 


11. pad 
is reserved for future expansion. 


12. nseq 
is the number of the highest video sequence defined for this terminal. 
Not all sequences are defined for all terminals, so programs should 
check this value before indexing the sequence array. 


13. sequences 
is an array of video sequences. Each element of the array specifies 
the character sequence for a video control operation. The indices 
for specific sequences are defined by constants also declared in 
this include file. See below. 


14.  video_chars 
is a string holding concatenations of all video sequences. 


The include file defines values for the indices into the array of sequences 
for the video operations supported. The names of these values are: ABS POS, 
CLEAR_SCREEN, CLEAR _TO_EOS, HOME, CLEAR TO EOL, CURSOR UP, CURSOR_RIGHT, 
CURSOR DOWN, CURSOR LEFT, INSERT CHARS, END INSERT CHARS, DELETE CHARS, 
INSERT LINES, DELETE LINES. The include file also defines N_VIDEO SEQUENCES, 
which is the number of the highest index ever defined. 


A video sequence is defined by the structure tty _video_seq, defined in the 
include file tty_video_tables.incl.pll. 


del 1 tty_video_seq based (ttyvseqp) aligned, 
2 flags unaligned, 
3 present bit (1) unal, 
3 interpret bit (1) unal, 
3 able to repeat bit (1) unal, 
3 ecpad present bit: 04) anal, 
3 cpad_in_chars bit (1) unal, 
3 pad bit (7) unaligned, 
3 general bit (6) unaligned, 
2 cpad fixed bin (18) unsigned unaligned, 
2 pad bit (15) unal, 
2 len fixed bin (9) unsigned unaligned, 
2 seq_index fixed bin (12) unsigned unaligned; 
where: 
1. present 
is "1"b if. the operation is supported. 
2. interpret 


is "1"b if the sequence contains the encoding of the line, column, 
or repeat count and must be inspected more closely. 
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3. able to repeat 
is "i"b if the terminal can perform multipie sequences of this operation 
by receiving a single character sequence containing the repeat count; 
the repeat count is encoded in the sequence. 


4, epad_ present 
is "1"b if the terminal requires padding after the operation. 


5, ¢pad_in chars 
is "1"b if the padding is in characters, or "0"b if the padding is 
in tenths of milliseconds. If the baud rate is supplied to the 
ttt_info $video info subroutine, then padding will always be expressed 
in characters. 


6. pad 
is reserved for future expansion. 


Te general 
is reserved for future expansion to define per-sequence information. 


8. epad 

is the padding count in units defined by cpad_in_ chars. 
9. pad 

is reserved for future expansion. 
10. len 


is the length of the string of characters defining this sequence. 


11. seq_index 
is the index of the start of the string in tty_video table.video chars. 


Many terminalis aliow a repetition count to be supplied with an operation 
(e.g., to delete multiple lines). Positioning operations require line and column 
coordinates. These values must be expressed in some encoding. A variety of 
encodings are supported. Parameters to be transmitted are specified by an encoding 
character in the video sequence string. An encoding character is a nine bit 
byte whose high order bit is set and is defined by the structure tty numeric encoding 
in the include file tty video tables.incl.pli. The encoding scheme is described 
in the write up for the video info table of the Terminal Type file. 


del 1 tty numeric encoding based unaligned, 
2 flags, 
3 must_be_on bit (1) unal, 
3 express in _decimal bit (1) unal, 
3 express in octal bit (1) unal, 


3 offset is 0 bit (1) unal, 
2 Le. orn fixed bin (2) unsigned unaligned, 
2 num_digits fixed bin (2) unsigned unaligned, 
2 pad bit (1) unaligned 
2 offset | fixed bin (8) unaligned; 
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where: 


1. must _be on 
is "1"b for an encoding character. 


2. express _ in decimal 
is "i"b if the value should be expressed as decimal digits. 


3. express in octal 
is "1"b if the value should be expressed in octal digits. If both 
flags are off, the value should be sent as a single character. 


4, offset is 0 
“if "O"b, the following byte is a fixed bin(8) value to be added to 
the value before encoding. If "1i"b, the offset is O and the next 
byte has no special significance. 


5. l corn 
~ specifies the type of value to be encoded. Its value may be 0, 1, 
or 2, and indicates that this encoding character specifies the line 
number, column number, or repeat count respectively. 


6. num_digits 
specifies the number of digits to be sent. A value of O causes all 
Significant digits to be sent, with leading zeroes suppressed. 


7. pad 
is reserved for future expansion. 


8. offset 


is present only if offset_is 0 is "O"b. It gives an offset to be 
added to the value before expressing it in octal or decimal. 


Entry: ttt_info $function_key data 


This entry point returns a collection of information describing the function 
keys of a specified terminal type. 
Usage: 

del ttt_info $function_key_ data entry (char(*), ptr, ptr, fixed bin (35)); 


call ttt_info $function key data (tt_name, areap, function key data ptr, 


code); 
where: 
1. tt_name (Input) 
is the terminal type name. 
26 areap (Input) 


points to an area where the function key data info structure may be 
allocated. If null, the system free area is used. If the area is 
not large enough, the area condition is signalled. 
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function key data ptr (Output) 


3. ss es 
points to the function key data structure allocated by this entry 
point. The structure is described below. 

4, code (Output) 
is a standard system status code. 

Notes 


The data structure allocated by this routine is declared in the include 


file function key data.incl.plt. 


del 1 function key data aligned based (function key data_ptr), 
2 version fixed bin, 
2 highest fixed bin, 
2 sequence, 
3 seq_ptr pointer, 
3 seq len fixed bin (21), 
2 cursor motion keys, 
home (0:3) like key_info, 
left (0:3) like key info, 
up (0:3) like key info, 
right (0:3) like key info, 
down (0:3) like key info, 
2 function keys (O:function key data highest refer 
(function_key data.highest), 0:3) like key _info; 


W WOW W 


del (KEY PLAIN init (0), 
KEY SHIFT init (1), 
KEY CTRL init (2), 
KEY CTRL AND SHIFT init (3) 
) fixed bin internal static options (constant); 


del 1 key info unaligned based (key _info ptr), 
2 sequence index fixed bin (12) unsigned unaligned, 
2 sequence length fixed bin (6) unsigned unaligned; 


where: 

1. version 
is the version of this structure. It should be set to 
function key data_version_1. 

33 highest 
is the number of the highest function key defined. 

36 sequence 


defines the character string holding the concatenation of all the 
sequences. The sequence for a given key is defined as a svutstring 
of this string. 
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13. 


14, 


15. 


seq ptr 
is the address of the string. 


seq_len 
is its length. 


cursor motion keys 
defines some miscellaneous keys whose names connote motion of the 
cursor. Note that the meaning of these keys is defined only by the 
application, which may or may not choose to take advantage of mnemonic 
value of these key legends. 


home 
defines the sequences for the HOME key, used by itself, with SHIFT, 
with CONTROL, and with SHIFT and CONTROL. An absent sequence will 
have a sequence length of zero. 

left 
defines the left arrow key in the same way as HOME is defined. 

up 
defines the up arrow key. 

right 
defines the right arrow key. 

down 


defines the down arrow key. 


function keys 
defines the sequences for the function keys of the terminal. If the 
terminal has no function key labelled "0", all sequences for O will 
have zero length. 


key_info 
defines a given sequence, 


sequence index 


is the index of the beginning of the sequence in the string of all 
sequences, 


sequence length 


is the length of the sequence. If the length is zero, the sequence 
is not present. 


Mnemonic values are defined for the subscripts for various key combinations: 


KEY PLAIN, KEY SHIFT, KEY CTRL, and KEY_CTRL_AND SHIFT. 


For example, the sequence for the LEFT arrow key with SHIFT would be: 
substr (function key seqs, 


function key data.left(KEY SHIFT).sequence offset, 
function key data.left(KEY SHIFT).sequence length) 
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INPUT/OUTPUT MODULES 


This section describes the tty  I/0 module, as well as the special purpose 
communications I/O modules. The conventions used in giving the formats of the 
attach descriptions are the same as those for the usage lines of commands. 
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Name: bisync_ 


The bisyne_ I/0 module performs stream I/0 over a binary synchronous 
communications channel. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


Attach Description 
bisyne_ device {-control_args} 


where: 


1. device 
is the name of the communications channel to be used for communications 
(see Appendix A for a discussion of channel names). 


2. control args 
ean be chosen from the following: 


-size N 
sets to N the number of characters to be transmitted in each bisyne 
block. The default is 256 characters. 


-ascii 
uses the ASCII bisyne protecol. This is the default. 


-ebcdic 
uses the EBCDIC bisyne protocol. 


-transparent 
uses the transparent bisynec protocol. This is the default. 


-nontransparent 
uses the nontransparent bisyne protocol. 


-bretb 
causes the get chars operation to return any block of data ending 
with an end of text block (ETB) character. The default is to return 
only blocks ending with an end of text (ETX) control character or an 
intermediate text block (ITB) control character (see the discussion 
of the get_chars operation below). 


-breot 
causes the get chars operation to return any block of data ending 
with an end of transmission (EOT) character (see the discussion of 
the get_chars operation below). 


-~hangup 
causes an automatic hangup when the switch is detached. 

-~bid_limit N 
sets to N the number of times a line bid is retried. The default is 
30 times. 
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-ttd_time N 
sets to N the number of seconds of temporary text delay (TTD) 
transmissions if output is delayed. The default is 2 seconds. 


-ttd limit N 
“sets to N the maximum number of TTDs that are sent before Sending an 
EOT. The default is 30 TTDs. 


-multi record {N} 
specifies that blocking of logical penenas is done - the I/O module. 
If specified, N is the maximum number of records per block. If N is 
not given, the number of records per block is as many as fit. 


Open Operation 


The bisyne_ I/0 module supports the stream_input, stream_output, and 
stream _input_output opening modes. 


Put Chars Operation 


The put chars entry splits the data to be written into blocks according to 
the -size control argument in the attach description. The appropriate bisyne 
control characters are added to the beginning and end of each block. -Each block 
except the last is transmitted with an ETB control character at the end. The 
last block is transmitted with an ETX control character at the end. 


Get Chars Operation 


The get _chars entry reads and decodes bisyne blocks, removes the control 
characters, and returns the message text to the caller's buffer. 


Characters are returned up to the next logical bisyne break character. 
Normally this is ETX. If -bretb is specified in the attach description, ETB is 
also considered to be a break character. If -multi_record is specified, the 
inter-record ITB characters are also considered to be break characters. In 
addition, if -breot is specified, error table $end of info is returned when an 
EOT is read. = ~ ie 


Get Line Operation 


The get_line entry reads and decodes bisyne blocks, removes the control 
characters, and returns the message text to the caller's buffer. Characters are 
returned until either a newline character is placed in the buffer, or the buffer 
is filled. The get _line entry does not distinguish between blocks ending in ETB 
or ITB and blocks ending in ETX. 
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Control Operation 


Several of the control operations supported by the bisyne I/0 module are 
identical to those supported by the tty _ I/O module, and are documented there. 
They include: 


abort 
resetread 
resetwrite 
hangup 

read_ status 
write status 
event _info 


The following additional control operations are supported by this I/0 module. 


set_bid limit 
where info _ptr points to a fixed binary bid limit to replace the bid limit 
specified in the attach description. 


get_bid limit 
- where info ptr points to a fixed binary bid limit that is set either 
to the value specified at attach or in the last get_bid_limit order. 


set_bsc_ modes 
where info ptr points to a structure of the following form: 


del 1 bse modes, 

> ~transparent bit(1) unal, 
ebedic bit(1) unal, 
mbz bit (34) unal; 


NM NM Po 


The setting of the transparent and ebcdic bits then replaces the values 
specified in the attach description. 


get_bsc_modes 
returns the structure described under set_bsec_modes. 


runout 
has meaning only in multi-record mode and writes the current partially 
filled block. 


set_size 
where info ptr points to a fixed binary buffer size. This new size 
replaces the size specified in the attach description. It may not be 


larger than the size originally specified in the attach description. 
get_size 


where info _ptr points to a fixed binary buffer size and returns the 
current size. 
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set_multi_record_mode 


where info ptr points to a fixed binary record count. If the count is 
1, the I/0 module enters single record mode. Otherwise, multi-record 
mode is entered and the count specifies the maximum number of records 
per block. Zero (or a null info ptr) specifies no fixed limit; i.e., 
as many records as fit are blocked. 


get_multi_record mode 


where info ptr points to a fixed binary record count. This order 
returns the multirecord record count. A 1 indicates single record 
mode. 


send _nontransparent _msg_ 


“writes the data specified in nontransparent bisyne mode, regardless of 
the current transparency mode. This order is used to send short 
nontransparent control sequences while in transparent mode. The info ptr 
points to a structure of the following form: - 


del 1 order _msg, 
2 data _len fixed bin, 
2. data char (order_msg.data len); 


end write mode 


causes the I/0 module to block until all outstanding output has been 
written. 


get_chars 


performs a get chars operation and returns additional information about 
the input. The info ptr points to a structure of the following form: 
del get_chars info, 

buf_ptr ptr, 

buf len fixed bin(21), 

data len fixed bin(21), 

hbuf ptr ptr, 

hbuf len fixed bin(21), 

header len fixed bin(21), 

flags, 

etx bit( 

etb bit( 

soh bit( 
( 
( 


MMMNMMND MP = 


) unal, 
) unal, 
) unal, 
eot bit(1) 
pad bit(32) 


unal, 
unal; 


CA) A) WW) UW 


1 
1 
1 
1 
3 
where: 


buf_ptr, buf_len (Input) 
define an input buffer for the text of the message. 


data_len (Output) 
is set to the number of characters of text read. 


hbuf_ptr, hbuf_len (Input) 
“define an input buffer for the header of the message. 


header_len (Output) 
is set to the header's length in characters. 


etx (Output) 
indicates that text is terminated with an etx character. 
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etb (Output) 
indicates that text is terminated with an etb character. 


soh (Output) 
indicates that the data includes a header. 


eot (Output) 
indicates that an eot was received. 


pad (Output) 
is unused space in this structure. 


hangup proc 
sets up a specified event call channel to be signalled over, and a 
procedure to be called, if the communications channel hangs up. The 
hangup_proc input structure has the following form: 


del 1 hangup proc aligned, 


2 entry entry variable, 
2 datap ptr, 
2 prior fixed bin; 
where: 
entry 


is the entry to call when a hangup is detected. 


datap 
is a pointer to data for the hangup procedure. 


prior . 
is the ipe event call priority to be associated with hangup 
notification. 


Modes Operation 


This I/0 module does not support the modes operation. 
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Name: 


$115 _ 


g115_ 


The g115 I/O module performs stream I/O to a remote I/O terminal that has 


the characteristics of the Honeywell Level 6 remote batch facility (G115 type). 
The hardware options currently Supported are defined by the control arguments 


deser 


ibed below. 


Entry points in this module are not called directly by users; rather, the 


module is accessed through the I/O system. 


Attach Description 


where 


g115_ -control args 


control arguments may be chosen from the following and are optional with 


the exception of -device, -tty, and -comm: 


Open 


-device STR 
attaches the subdevice specified by STR. STR may be printer, punch, 
reader, or teleprinter. 


-auto call N 


specifies the phone number, N, to be called via the auto call unit 
on the specified communications channel. 


-tty STR 
connects the remote I/O terminal to the communications channel named 
SLRs 

-~comm STR 
uses the communications I/O module specified by STR. Currently, the 
only permissible value for STR is "rei". This argument is required 


for compatibility with all other I/O modules used by the I/O daemon. 


~-ascii 
uses the ASCII character set. This is the default. This argument 
is accepted for compatibility with other terminal I/O modules. 


-physical line length N, -pll N 
specifies the physical line length, N, of the output device. This 
argument is accepted for compatibility with other terminal I/O modules. 


-terminal type STR, -ttp STR 
STR specifies the terminal type whose conversion, translation, and 
special tables defined in the user or system terminal type table 
(TTT) are used to convert and translate input and output to and from 
the device. If not specified, no conversion or translation is performed. 
For more information about the allowable conversion values see "Notes" 
below. 


Operation 


The g115 I/O module supports stream input, stream output, and 


stream input output opening modes. 


7/82 
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Put Chars Operation 


The put_chars entry blocks the data to be written into blocks of up to 324 
characters and transmits them to the specified communications channel. 


Get Chars Operation 


The get chars entry reads blocks of up to 324 characters and returns the 
number of characters requested up to the next record separator. 


Control Operation 


This I/O module supports all the control operations supported by the tty_ 
I/O module. In addition, it supports the following: 


select device 


selects the subdevice, either printer, punch, or teleprinter, to which 
output is next directed. The input structure is of the form: 


del device char(32); 


runout 


transmits any data stored in the output buffer. There is no input 
Structure. 


hangup proc 
sets up a specified event call channel to be signalled over, and a 
procedure to be called, if the communications channel hangs up. The 
hangup proc structure has the following form: 


del 1 hangup proc aligned, 
2 entry entry variable, 
2 datap ptr, 
2 prior fixed bin; 


where: 


entry 
is the entry to call when a hangup is detected. 


datap 
is a pointer to data for the hangup procedure. 
prior 
is the ipce_ event call priority to be associated with hangup 
notification. 
reset 


sets the edited mode of output conversion. 
end write mode 


~ prevents the g115_ module from returning until all outstanding output 
has been written to the attached channel. 
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Modes Operation 


This I/O module supports the rawi and rawo modes. It also Supports the 
nonedited and default modes, which set and reset the edited output conversion, 
if it has been enabled by the -terminal type control argument. 


Notes 


The only allowable values in the output conversion table are 00 and any 
values greater than 16. All values defined in the description of the tty I/0 
module are allowed for input conversion. Input and output translation tables 
may be up to 256 characters in length. 
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Name: hasp_ host_ 


The hasp_ host _ I/0 module simulates record oriented I/0 to a single device 
of aworkstation while communicating with a host system using the HASP communications 
protocol. See the "Notes" below for more detail. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


This I/O module must be attached to a subchannel of a communications channel 
configured to use the HASP ring-0 multiplexer. See the description of the HASP 
multiplexer in MAM Communications. 


This I/O module is designed primarily for use by the Multics I/O daemon. 


Attach Description 
hasp_host_ -control_ args 


where control arguments may be chosen from the following and are optional, with 
the exception of -comm, -tty, and -device: 


-comm hasp 
is required for compatibility with other I/O modules used by the I/0 
daemon. 


-tty channel name 
specifies the communications channel to be attached. The channel 
must be a Subchannel of a HASP multiplexed channel (e.g., a.hO14.prt3). 


-device STR 
specifies the type of device for this attachment. STR must be one 
of "teleprinter", "reader", "printer", or "punch". The type specified 
by this control argument must match the type of device attached to 
the channel name defined above. 


-terminal type STR, -ttp STR 
is optional and is used to define the character set used by the 
remote system. STR must be the name of a terminal type defined in 
the site's Terminal Type Table (TIT). See the section "Character 
Set Specification" below for more information, including the default 
character set used if this control argument is omitted. 
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-physical line length N, -pll N 


is accepted for compatibility with other J/0O modules used by the I/0 
daemon, but is ignored by this I/0 module. 


-ebcdic 


is accepted for compatibility with other I/0 modules used by the I/0 
daemon, but is ignored by this I/0 module. 


Open Operation 


The hasp host _ I/0 module supports the sequential input, sequential output, 
and sequential __ input_ output opening modes. 


Write Record Operation 


The write record entry converts the supplied data record from ASCII to the 
remote system's character set, performs data compression, and transmits the record 
to the HASP multiplexer. 


The format of the record supplied to this I/0 module follows. This structure 
and the referenced constants are contained in the terminal io record.incl.pl} 
include file: 


del 1 


2 
2 
2 


MN PO Po 


where: 


version 


terminal io record aligned based, 

version fixed binary, 

device type fixed binary, 

Slew control, 

3 slew_type fixed binary (18) unaligned unsigned, 

3 slew_ count fixed binary (18) unaligned unsigned, 

flags, 

3 binary bit (1) unaligned, 

3 preslew bit (1) unaligned, 

3 pad bit (34) unaligned, 

element size fixed binary, 

n_elements fixed binary (24), 

data, 

3 bits (terminal _io record n_ elements refer 
(terminal io record.n elements) ) 

bit (terminal io record element_ size refer 

(terminal_io record.element_size)) unaligned; 


(Input) 


is current the version of this structure. This version of the structure is 


given 


device type 
is the 
Values 


by the value of the named constant terminal io record_version_1. 
(Input) 


type of device to which this record is to be written. The acceptable 
are TELEPRINTER DEVICE and READER DEVICE. 
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slew _control (Input) 
is ignored by this I/O module as the HASP communications protocol does not 
define slew operations for either the teleprinter or card reader. 
flags.binary (Input) 
must be set to "O"b, (This I/O module does not support binary data 
transmission.) 
flags.preslew (Input) 
must be set to "0O"b, 
element size (Input) 
must be set to 9 (This I/O module only supports transmission of characters.) 
n elements (Input) 
is the number of characters in the record to be written. 
data.bits (Input) 


is the actual data. This I/O module expects to be sipered ASCII characters, 


Read Record Operation 


The read record entry returns a single record from the device, basically 
performing the inverse of the functions described for the write record operation. 
Additionally, for line printer attachments, the carriage control information in 
the record is converted into the appropriate slew information in the 
terminal _io record. 


The format of the record which this I/O module returns in the supplied 
buffer is as follows. The structure and the referenced constants are contained 
in the terminal_io_ record include file: 


del 1 terminal io record aligned based, 
2 version fixed binary, 
2 device type fixed binary, 
2 slew control, 
3 slew _type fixed binary (18) unaligned unsigned, 
3 slew count fixed binary (18) unaligned unsigned, 
2 flags, 
3 binary bit (1) unaligned, 
3 preslew bit (1) unaligned, 
3 pad bit (34) unaligned, 


2 element size fixed binary, 
2 n_elements fixed binary (24), 
2 data, 
3 bits (terminal io record n elements refer 
(terminal io record.n elements) ) 
bit (terminal io record element size refer 
(terminal __ io _record.element _Size)) unaligned; 
where: 
version (Output) 


is the current version of this structure. This version of the structure is 
given by the value of the named constant terminal _io record version 1. 
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device type (Output) 
is the type of device from which this record was be read. Its possible 
values are TELEPRINTER DEVICE, PRINTER DEVICE, or PUNCH DEVICE. 


slew_control (Output) 
if the input device is a line printer, this sub-structure is filled in with 
the interpretation of the HASP carriage control record present in each line 
printer record; otherwise, it is always set to the value specified below. 


slew type (Output) 

“for a line printer, is set to the type of slew operation to be performed 
before/after "printing" the data in the record and may be either SLEW BY COUNT 
or SLEW TO CHANNEL. For a teleprinter or punch it is set to SLEW BY COUNT. 
(The data returned is processed by the caller of this I/0 module; this 
processing is herein termed the "printing" of the data.) 


slew_count (Output) 
for a line printer, is set to the value to be interpreted according to 
Slew control.slew type above. For a teleprinter or punch it is set to 1. 
(Output) 7 


flags.binary (Output) 
is always set to "O"b. 


flags.preslew (Output) 
for a line printer, is set to "1"b if the slew operation above is to be 
performed before "printing" the data in the record or is set to "0"b if the 
Slew operation is to be performed after "printing". For other than the 
line printer, it is always set to "0O"b. 


element size (Output) 
is always set to 9. 


n elements (Output) 
is set to the number of characters returned in the record. 


data.bits (Output) 


is the actual returned data. This I/0 module will convert the data input 
from the remote host to ASCII. 


Control Operation 


This I/O module supports the following control operations: 


runout 
ensures that all data has been transmitted to the HASP multiplexer 
from where it is guaranteed to be transmitted to the terminal. 


end write mode 


ensures that all previously written data has been transmitted to the 
HASP multiplexer and then writes an end-of-file record for the device. 
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read status 
“determines whether or not there are any records waiting for a process 
to read. The info ptr should point to the following structure, which 
is filled in by the call: 


del 1 info structure aligned, 
2 ev_chan fixed bin (71), 
2 input_available bit (1); 


where: 


ev_chan : (Output) 
is the event channel used to signal the arrival of input. 


input available (Output) 
‘indicates whether input is available: 
TO'b no input 
"T®D input 


resetread 
discards any pending input. 


resetwrite 
discards any as yet unprocessed output. 


hangup proc 
is used to specify a procedure to be invoked when this attachment's 
channei is hung up. The info ptr points to the following structure: 


dcl 1 hangup proc_info aligned, 
2 procedure entry variable, 
2 data ptr pointer, 
2 priority fixed binary; 


where: 


procedure (Input) 
is the procedure to be invoked when the hangup occurs. 


data ptr (Input) 
is a pointer to be supplied to the procedure. 


priority (Input) 
is the priority for the hangup event. 


A detailed explanation of data ptr and priority may be found in the 
description of ipe_ in the MPM Subsystem Writer's Guide. 


select device, and 

reset 
are ignored rather than rejected for compatibility with other I/0 modules 
used by the I/O daemon. 


Ssignon record 
no signon_record 
~ may only be issued on the operator's console subchannel of the multiplexer. 
These are described in the "SIGNON Processing" section. 
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Modes Operation 


This module accepts the "non edited" and "default" modes for compatibility 
with other I/O modules used by the I/O daemon, but ignores them. 


Character Set Specification 


This I/O module allows the specification of the character set used by the 
remote system through the -terminal type attach option. 


If -terminal type is given, the referenced terminal type must be defined in 
the site's TIT with both an input and output translation table. This module 
will use these translation tables to convert data from the remote system to 
ASCII, and from ASCII to the remote system's character set. 


If -terminal type is not given, the remote system is assumed to use EBCDIC 
as its character set. In this case, the subroutine ascii_to_ebedic_ is used to 
convert data sent to the system; the subroutine ebcdic to ascii is used to 
‘convert data received from the remote system. (See MPM Subsystem Writers' Guide 
for a description of these translations.) 


SIGNON Processing 


Before communicating with certain remote systems, Multies must send the 
SIGNON record. This specialiy formatted record identifies Multics to the remote 
system. 


For these systems, the Multics multiplexer must be configured to use 
"signon_ mode" (see MAM Communications). Before data transmission is permitted, 
the signon record control order must be issued on an I/O switch attached to the 
operator's console subchannel of the multiplexer. 


If the remote system does not expect a SIGNON record, the "no _signon_record" 
control order may be used to validate that the multiplexer channel is properly 
configured. 


signon_record CONTROL ORDER 


This control order supplies a SIGNON record for transmission to the remote 
system. The info ptr must locate the following structure which is declared in 
the include file hasp signon_record_info.incl.pl1: 

del 1 signon record_info aligned based, 
2 version fixed binary, 

2 pad bit (36), 
2 event channel fixed binary (71), 
2 record character (80) unaligned; 
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where: 


version 


is the current version of this structure. It must have the value of the 
named constant SIGNON RECORD INFO VERSION 1. 


pad 
is reserved for future expansion and must be zero. 


event channel 
is an event-wait channel whose usSe is described below. 


record 
is the actual text of the SIGNON record in ASCII. This I/0 module will 
translate the text to uppercase and the remote system's character set. 


If the status code returned by this control order is zero, the calling 
program must block on the above event-wait channel. When the wakeup arrives, 
the event message will indicate the success or failure of the control order. It 
will have one of the following values (found in the named include file): 


HASP_SIGNON OK 
indicates that the remote system has accepted the SIGNON record. 


HASP_ SIGNON REJECTED 
indicates that the remote system has rejected the record; the caller 
should try again with a different record. 


HASP_SIGNON HANGUP 


indicates that the remote system has rejected the record and disconnected 
the multiplexer. 


If the status code returned by the control order is error table $invalid state, 
the multiplexer is not configured to send a SIGNON record. 


no signon_record CONTROL ORDER 


This control order validates that the multiplexer is not configured to send 
a SIGNON record to the remote system. This order does not accept an info structure. 


If the returned status code is error_table $invalid_ state, the multiplexer 
is configured to send a SIGNON record, and a "signon_record"™ must be issued on 
this subchannel. 
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Notes 


As stated above, this I/O module is used to simulate the operation of a 
Single device of a HASP workstation. 


If the simulated device is a card reader, the caller supplies records to 
this module which are then formatted and transmitted to the remote host. In 
other words, a card reader attachment through this switch is an output-only 
attachment. 


Similarly, this I/O module receives records from the remote host when the 
simulated device is either a line printer or card punch. Thus, line printers 
and card punches attached through this I/O module are input-only devices. 


Special I/0 daemon software is provided to allow Multics to simulate the 
operations of a workstation in order to submit jobs to remote systems and receive 
those jobs' output print and punch files. This workstation simulator uses this 
I/O module for communications with the remote host. 
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Name: hasp_workstation_ 


The hasp_ workstation I/O module performs record oriented I/0 to a single 
device of a remote terminal that supports the HASP communications protocol. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


This module must be attached to a subchannel of a communications channel 
configured to use the HASP ring-O multiplexer. (See the description of the HASP 
multiplexer in MAM Communications.) 


The module is designed primarily for use by the Multics I/O daemon. It 
expects output for the operator's console and line printers to have been properly 
formatted by the prt_conv_ module. 


Attach Description 
hasp_workstation_ -control_args 


where control arguments may be chosen from the following and are optional, with 
the exception of -comm, -tty, and -device: 


-comm hasp 
is required for compatibility with other I/O modules used by the I/0 
daemon. 


-tty channel name 
specifies the communications channel to be attached. The channel 
must be a subchannel of a HASP multiplexed channel (eg: a.hO14.prt3). 


-device STR 
specifies the type of device for this attachment. STR must be one 
of "teleprinter", "reader", "printer", or "punch", The type specified 


by this control argument must match the type of device attached to 
the channel name defined above. 


-terminal type STR, -ttp STR 
is optional and is used to define the character set used by the 
remote terminal. STR must be the name of a terminal type defined in 
the site's Terminal Type Table (TTT). See the section "Character 
Set Specification" below for more information, including the default 
character set used if this control argument is omitted. 


-physical line length N, -pil N 


is accepted for compatibility with other I/O modules used by the I/0 
daemon, but is ignored by this I/0 module. 
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-ebcdic 
is accepted for compatibility with other I/O modules used by the I/0 
daemon, but is ignored by this I/0 module. 


-top of page STR 
specifies the sequence of carriage control operations to be used to 
move to the top of the next page. This control argument is only 
permitted for a line printer. The format of STR is described in 
"Carriage Control Specifications" below. (Default is "e1".) 


-inside page STR 
specifies the sequence of carriage. control operations to be used to 
move to the top of the next "inside" page. An "inside" page is the 
page on which the I/O daemon will print head sheets. This control 
argument is only permitted for a line printer. The format of STR is 
described in "Carriage Control Specifications" below. (Default is 
No1",) 


-outside page STR 
specifies the sequence of carriage control operations to -be used to 
move to the top of the next "outside" page. An "outside" page is 
the page on which the I/O daemon will print tail sheets. This control 
argument is only permitted for a line printer. The format of STR is 
re ies in "Carriage Control Specifications" below. (Default is 
Nop", 


-forms STR 
specifies the type of forms to be used to print output directed 
through this attachment. STR is an arbitrary string of, at most, 32 
characters whose interpretation is site dependent. This control 
argument is only permitted for a line printer. (Default is the null 


string.) 
Operation 
The hasp workstation 1/0 moduie Supports the sequential input, 


sequential_output, and sequential_input_output opening modes. 


Write Record Operation 


The write record entry converts the supplied data record from ASCII to the 


remote terminal's character set, converts the supplied slew control into the 
proper carriage control sequences for line printer attachments, performs data 
compression, and transmits the record to the HASP multiplexer. 


6-19 CC92-01 


hasp_workstation_ hasp_ workstation _ 


The format of the record supplied to this I/0 module follows. This structure 
and the referenced constants are contained in the terminal _io record include 
file: 


del 1 terminal io record aligned based, 

version fixed binary, 

device type fixed binary, 

slew control, 

3 slew_type fixed binary (18) unaligned unsigned, 
3 slew_count fixed binary (18) unaligned unsigned, 
2 flags, 


Ina + 


2 
We ur ( 
3 binary bit (1) Nail ign ea, 


NM PMH 


“ 
5 
7) 
re 
= 
) 
u 


4 
1 
3 preslew bit 1) Gunel ened. 

3 pad bit (34) unaligned, 

element size fixed binary, 

n elements fixed binary (24), 

data, 

3 bits (terminal io record n elements refer 

(terminal io record.n elements) ) 

bit (terminal io record element size refer 
(terminal _io record.element_size)) unaligned; 


NM PM P 


where: 


version (Input) 
is the current version of this structure. This version of the structure 
is given by tne value of the named constant terminal _ io record version 1. 


device type (Input) 
is the type of device to which this record it to be written. The 
acceptable values are TELEPRINTER DEVICE, PRINTER DEVICE, or 
PUNCH DEVICE. - 


slew control (Input) 
“need only be supplied by the caller if device type is PRINTER DEVICE 
and specifies the slew operation to be performed after printing the 
data in the record. 


slew_type (Input) 
specifies the type of slew operation. The possible values are 
SLEW BY COUNT, SLEW TO TOP OF PAGE, SLEW_TO_INSIDE PAGE, 


SLEW_TO_ OUTSIDE PAGE, or SLEW TO_ CHANNEL. 


slew_count (Input) 
is interpreted according to the value of slew_control.slew type. 


flags.binary (Input) 
must be set to "O"b, (This I/O module does not support binary data 
transmission.) 


flags.preslew (Input) 
must be set to "O"b. (This I/O module does not support slew operations 
before printing the record's data.) 


element size (Input) 


must be set to 9. (This I/O module only supports transmission of 
characters.) 
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n elements (Input) 
is the number of characters in the record to be written. 


data.bits (Input) 
is the actual data. This I/O module expects to be supplied ASCII 
characters. 


Read Record Operation 


The read_record entry returns a single record from the device, basically 
performing the inverse of the functions described for the write record operation. 


The format of the record this I/O module returns in the supplied buffer 
follows. This structure and the referenced constants are contained in the 
terminal io_record include file: 


del 1 terminal_io_ record aligned based, 

version fixed binary, 

device type fixed binary, 

slew control, 

3 slew_type fixed binary (18) unaligned unsigned, 

3 slew count fixed binary (18) unaligned unsigned, 

2 flags, 

3 binary bit (1) unaligned, 

3 preslew bit (1) unaligned, 

3 pad bit (34) unaligned, 

element size fixed binary, 

n elements fixed binary (24), 

data, 

3 bits (terminal io record n elements refer 
(terminal io Frecord.n elements) ) 

bit (terminal io record element size refer 

(terminal io record. element_ size)) unaligned; 


MMP 


NM MP 


where: 


version ~ (Output) 
is the current version of this structure. This version of the structure is 
given by the value of the named constant terminal_io record_version_1. 


device type (Output) 
is the type of device from which this record was read. Its possible values 
are TELEPRINTER DEVICE or READER DEVICE. 


Slew_control.slew_ type (Output) 
is always set to SLEW _BY_ COUNT. 


Slew_control.slew_count (Output) 
is always set to 1. 


flags.binary (Output) 
is always set to "0O"b. 


flags.preslew (Output) 
is always set to "0O"b. 
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element size (Output) 
is always set to 9. 


n elements (Output) 
is set to the number of characters returned in the record. 


data.bits (Output) 
is the actual returned data. This I/0 module will convert the data input 
from the remote workstation to ASCII. 


Control Operation 


This I/O module supports the following control operations: 


runout 
ensures that all data has been transmitted to the HASP multiplexer 
from where it is guaranteed to be transmitted to the terminal. 


end_write mode 
ensures that all previously written data has been transmitted to the 
HASP multiplexer and then writes an end-of-file record for the device, 


read status 
“determines whether or not there are any records waiting for a process 
to read. The info ptr should point to the following structure, which 
is filled in by the call: 


del 1 info_structure aligned, 
2 ev_chan fixed bin (71), 
2 input_available bit (1); 


where: 


ev_chan (Output) 
is the event channel used to signal the arrival of input. 


input_available (Output) 
indicates whether input is available: 
vO" b no input 
W1"b input 


resetread 
flushes any pending input. 


resetwrite 
flushes any as yet unprocessed output. 


hangup proc 
is used to specify a procedure to be invoked when this attachment's 
channel is hung up. The info ptr points to the following structure: 
del hangup proc _ info aligned, 
procedure entry variable, 
data_ptr pointer, 
priority fixed binary; 


MMN — 
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where: 


procedure (Input) 
is the procedure to be invoked when the hangup occurs. 


data ptr (Input) 
is a pointer to be supplied to the procedure. 


priority (Input) 
is the priority for the hangup event. 


A detailed explanation of data ptr and priority may be found in the 
description of ipe_ in the MPM Subsystem Writer's Guide. 


select_device, and 

reset 
are ignored rather than rejected for compatibility with other I/0 modules 
used by the I/O daemon. 


Modes Operation 


This module accepts the "non edited" and "default" modes for compatibility 
with other I/O modules used by the I/O daemon, but ignores them. 


Character Set Specification 


This I/O module allows the specification of the character set used by the 
remote workstation through the -terminal type attach option. 


If -terminal type is given, the referenced terminal type must be defined in 
the site's TTT with both an input and output translation table. This module 
will use these translation tables to convert data from or to the remote workstation 
from or to ASCII, respectively. 


If -terminai type is not given, the remote system is assumed to use EBCDIC 
as its character set. In this case, the subroutine ascii_to_ebcedic_ is used to 
convert data sent to the workstation; the subroutine ebcdic to_ascii_ is used to 
convert data received from the remote system. (See MPM Subsystem Writers' Guide 
for a description of these translations.) 
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Carriage Control Specifications 


Multics I/O daemon software uses three special slew operations -- skip to 
top of the next page, skip to top of the next inside page, and skip to the top 
of the next outside page. (An inside page is the type of page on which the I/0 
daemon would print a head sheet; an outside page is the type on which it would 
print a tail sheet.) 


By default, this I/0 module assumes that all of these slew operations can 


be simulated on the reémote workstation'’s line printer by skipping to channel 
one. However, through use of the -top of page, -inside page, and -outside page 


control arguments, any sequence of carriage motions may be specified to simulate 
these slew operations. 

The format of this carriage control specification is: 

THPIN EIN st se 
where "n" is a numeric value and "T" represents how to interpret that numeric 
value. "T" may be either "c" representing skip to channel "n", or "s" representing 
Slew "n" lines. 

For example, the string: 

Gfzs57e12 


means skip to channel seven, space five lines, and finally skip to channel 
twelve. 
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Name: ibm2780_ 


The ibm2780_ I/0 module performs stream I/0 to a remote I/O terminal that 
has the characteristics of an IBM 2780 data transmission terminal. The hardware 
options currently supported are defined by the control arguments described below. 


. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/0 system. 


This module in turn constructs an attach description for the module specified 
in the -comm control argument, passing the attach information for ascii or ebcdic, 
tty, transparent or nontransparent, and all other attach information specified 
by the caller. 


Attach Description 
ibm2780_ -control_args 


where control arguments may be chosen from the following and are optional, with 
the exception of ~tty and -comm: 


-ascii 
transmits control information and data in ASCII. 


-ebcdic 
converts control information and data to its EBCDIC representation 
before transmission. This is the default. 


-multi_record 
transmits multiple records (up to 7) as a block, rather than separately. 
The default is single record transmission. , 


-physical line length N, pll N 
sets the maximum character width of the remote I/O terminal printer 
to N characters. The default is 80 characters. This variable is 
used to set tabs and pad records if the transparent option is specified. 


~horizontal tab, -htab 
Supports tab control on the remote I/O terminal printer. Tabs are 
set every 10 spaces. The default is no tab control. 


-tty STR 
connects the remote I/O station to the communications channel named 
STR. 

-comm STR 


uses the communications I/0 module specified by STR. 


-transparent 
uses a transparent communication protocol. 


-nontransparent 
uses a nontransparent communication protocol. This is the default. 
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species that this attachment is associated with the device STR. 
Currently, it is accepted only for compatibility with other I/O modules. 


-carriage ctl STR 
the eight-character string STR, taken two characters at a time, sets 
the four carriage control characters that specify the advance of 0, 
1, 2, and 3 lines. The default set of characters is ESC/, ESC/, 
ESCS, and ESCT, where the mnemonic ESC means the ASCII escape character. 


-slew_ etl STR 


the six-character string STR, taken two characters at a time, sets 
the slew control characters that specify top of form, inside page, 
and outside page. The default set of characters is ESCA, ESCA, and 


ESCA. 


-printer_ select STR 
the two-character string STR sets the printer select. The default 
printer select string is ESC/. 


-punch select STR 
the two-character string STR sets the punch select. The default 
punch select string is ESC4. 


-terminal_ type STR, -ttp STR 
STR specifies the terminal type whose conversion, translation, and 
special tables defined in the user or system terminal type table 
(TTT) are used to convert and translate input and output to and from 
the device. If not specified, no conversion or translation is performed. 
For more information about the allowable conversion values see "Notes" 
below. 


Open Operator 


The ibm2780 I/O module supports stream_input, stream_output, and 
stream_input_output opening modes. 


Put Chars Operation 


The put chars entry splits the data to be written into blocks of 80 or 400 
characters, depending on whether multirecord mode is enabled, and transmits the 
number of characters specified to the specified communications I/0 module. The 
blocks are of fixed or variable length, depending on whether transparent mode is 
enabled or not, respectively. 


Get Chars Operation 


The get_chars entry reads characters up to 80 or 400 characters, depending 
on whether multirecord is enabled, and returns the number requested, up to the 
next record separator. 
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Controi Operation 


This I/O module supports all the control operations supported by the 
communications I/O module specified in the attach description. In addition, it 
supports the following: 


set bse modes 
-  “ sets the character mode, either ascii or ebcdic and transparency. The 
input structure is defined as follows: 
del 1 set bse. modes aligned, 
2.char_mode bit(1), unaligned, 
2 transparent bit(1) unaligned; 
where char mode = "1i"b if ebcedic and "0"b if ascii, and transparent = 
"1"b if transparency is enabled and "0"b if not. 


select device 
selects the subdevice (either printer, punch or teleprinter) to which 
output is next directed. The input structure is of the form: 
del device char(32) based; 


set_multi_record_mode 
sets the number of records per block. The input structure is of the 
form: 
del record number fixed bin based; 


Modes Operation 


This module supports the nonedited and defauit modes, which set and reset 
the edited output conversion, if it has been enabled by the -terminal type control 
argument. 


Notes 


The only allowable values in the output conversion table are 00 and any 
values greater than 16. All values defined in the description of the tty I/0 
module are allowed for input conversion. Input and output translation tables 
may be up to 256 characters in length. 
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Name: ibm3270 | 


The ibm3270 1/0 module performs stream I/O to and from an IBM 3270 Information 
Display System (or any compatible device) over a binary synchronous communications 
channel. 


NOTE: Do not use this module to communicate with a 3270 device over a 
multiplexed channel. Use the tty module in that case. 


This module description assumes a knowledge of the IBM 3270 communications 
protocol as described in the IBM 3270 Information Display System Component 
Description, Order No. GA27-2749-H. 


Entry points in this module are not called directly by the user; rather, 
the module is accessed through the I/O system. 


Attach Description 


ibm3270_ device {-control args} 


where: 
1s device 

is the name of the communications channel to be used. 
2. control args 


can be chosen from the following: 


-asyne 
specifies that the I/0 module is to return to its caller immediately 
after performing a read order (described below under "Control 
Operation") when input is not available, rather than blocking and 
waiting for a response from the device. 


-ebcdic 
uses the EBCDIC bisyne protocol and character code. This is the 
default. 

-ascil 


uses the ASCII bisyne protocol and character code. 


Open Description 


This I/O module supports only the stream input output opening mode. If the 
~asyne control argument is specified in the attach description (see above), the 
open operation may return the Status code error table $request pending; in this 
case, the caller should perform an event info order (see below, "Control Operation") 
and block on the returned event channel; when the process receives a wakeup on 
this channel, the open operation should be retried. 
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Put Chars Operation 


This I/O module does not support the put _chars operation. Output is sent 
to the device by means of the write order (see "Control Operation" below). 


Get Chars Operation 


This I/O module does not support the get chars operation. Input is read 
from the device by means of the read order (see "Control Operation" below). 


Get Line Operation 


This I/O module does not support the get_line operation. 


Control Operation 


This I/O module supports all the orders supported by the tty I/0 module, 
as well as those described below. All orders are supported when the I/0 switch 
is open, except for event_info, which is supported when the I/O switch is attached. 


event_info 
returns the name of the event channel over which wakeups are sent when. 
input or status is received from the communications channel. The info ptr 
must point to an aligned fixed binary (71) number, in which the value 
of the event channel is returned. This order should be used if the 
-asyne control argument appears in the attach description (see "Attach 
Description" above). 


general poll 
causes a general poll operation to be initiated at the 3270 controller. 
Once the I/O switch is open, either a general poll order or a poll 
order (see below) must be issued before any input can be received; 
however, the general poll order does not have to be repeated, as polling 
is automatically resumed when appropriate by the I/O module. Theinfo ptr 
is not used. - 


stop general poll 
causes automatic general polling to stop; polling is not resumed until 
a general poll order is issued. The info ptr is not used. 


poll 
causes a specific poll operation to be performed on a single device 
connected to the controller. The info ptr must point to a fixed binary 
number containing the identification number of the device to be polled. 
To ensure that the device is polled as soon as possible, this order 
usually should be preceded by a stop general poll order. 
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read 


ibm3270_ 


causes input or status information from a single device to be returned, 
if any is available. If no status or input is available for any 
device on the communications channel, then the process blocks if the 
-asyne control argument was not specified in the attach description; 
if it was specified, a status code of error table $request pending is 
returned. ~ 7 


The info ptr must point to a user-supplied structure of the following 
form: 


AAT 1 wnanA antl aliansads 
USL t i ipiane be Vl ee Sores 
2 version fixed bin, 
2 areap ptr, 
2 read_infop ptr, 
2 max_len fixed bin, 
2 max_fields fixed bin; 
where: 
version (Input) 


is the version number of the structure. It must be 1. 


areap (Output) 
is a pointer to an area in which the read info structure (see 
below) is allocated. 


read _infop (Output) 
is a pointer to the read_info structure (see below). 


max len (Output) 
is the largest number of characters that can be returned in a 
single data field (see below). 


max fields (Output) 
is the largest number of data fields (see below) that can be 
returned in the read _info structure. 


A read info structure is allocated by the I/O module at the address 
specified by read ctl.read infop. This structure must be freed by the 
calling program. The read info structure has the following form: 
del 1 read_info aligned based (read_ctl.read_infop), 

2 version fixed bin, 
2 next_read infop ptr, 
2 controller fixed bin, 
2 device fixed bin, 
2 reason, 

3 key fixed bin, 

3 sub_key fixed bin, 

3 code fixed bin(35), 
2 status, 
3 bits bit(12) unal, 
3 fill bit (24) unal, 
cursor position fixed bin, 
max_fields fixed bin, 
max_len fixed bin, 
mod fields fixed bin, 
data (read ctl.max fields refer (read info.max fields)), 
3 field position fixed bin, > - 
3 contents char (read_ctl.max_len 


refer (read info.max len)) var; 


MOM MwNM PM 
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where: 


version 
is the version number of this structure. The structure described 
here is version 1. 


next_read_ infop 
“is a pointer to the next read info structure used by the I/0 
module. (The calling program should not attempt to make use of 
this item.) 


controller 
is the identification number of the 3270 controller from which 
the data or status has been received. 


device 
is the identification number of the particular device (attached 
to the specified controller) that produced the data or status 
information. 


reason 
describes the event that caused the structure to be filled in. 


key 
identifies the nature of the event, which is either an error or 
Status condition or an action on the part of the 3270 operator. 
It may have any of the following values: 


| -- an error was detected at the device. A status code describing 
the error is returned in reason.code (see "code" below). 


2 -- the device reported status. The particular status is described 
by status.bits (see "status" below). 


3 -- the operator pressed the ENTER key. 

4 -- the operator pressed one of the program function (PF) keys. 
The particular key is identified by reason.sub_key (see 
"sub_key" below). 

5 -- the operator pressed one of the program attention (PA) keys. 
The particular key is identified by reason.sub key (see 
"sub key" below). 


6 -- the operator pressed the CLEAR key. 


7 -- the operator inserted acard in the identification card reader. 
8 -- the operator used the selector pen on an "attention" field. 
9 -- the operator pressed the TEST REQUEST key. 

sub_key 


is the number of the PF or PA key pressed if reason.key is 4 or 
5, respectively. 


code 
is a status code describing an error at the device if reason.key 
is 1. 


status 
contains the device status if reason.key is 2. 
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cursor _position 
is the current position of the cursor on the display screen. 


max fields 
is the number of. elements in the data-array (below). 


max_len 
is the length of the longest contents string (below). 


mod fields 


is the number of elements in the data array (below) that are 
n ce of 


actually filled in in this in f the structure. 


ta 
ct 
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data 
describes the data fields containing the input. No data fields 
are provided if reason.key is 1, 2, 5, or 6. 


field position 
is the starting buffer address of the data field. 


contents 
is the contents of the data field. It is always a null string if 
reason.key is 8. 


causes commands and data to be sent to the 3270. The info ptr must 
point to a user-supplied structure of the following form: a 
del write info aligned, 

version fixed bin, 
controller fixed bin, 
device fixed bin, 
from_device fixed bin, 
command fixed bin, 
write ctl char, 
3 bits unal, 
print format bit(2) unal, 

4 start printer bit(1) unal, 

4 sound alarm bit(1) unal, 

4 keyboard restore bit(1) unal, 

4 reset _mdt bit(1) unal, 
3 copy_bits bit(2) unal, 
3 pad bit(28) unal, 
max fields fixed bin, 
max len fixed bin, 
mod fields fixed bin, 
data (max_write fields 

refer (write info.max fields)), 

3 orders unal, | 7 : 
set buffer addr bit), 
start field bit(1), 
insert_cursor bit(1), 
program tab bit(1), 
repeat_to_addr bit(1), 
erase to addr bit(1), 
3 attributes unal, 

4 protected bit(1), 

4 numeric bit(1), 

4 display form bit(2), 
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4 reserved bit(1), 
4 mdt bit(i), 


3 padi bit(12) unal, 
3 field position fixed bin, 
3 contents char (max write len 
refer (write info.max_len)) var; 
where: 
version 


is the version number of the structure. It must be 1. 


eontroller 
is the identification number of the 3270 controller to which the 
data is to be sent. 


device 
is the identification number of the device on that controller to 
which the data is to be sent. 


from_device 
is the identification number of the device to be used as the 
"from" device for a copy command. 


command 
is the command to be sent to the device. It may have any of the 
following values: 


1 -- write 

2-- erase/write 

i CORY 

4 -- erase all tinproteetea? 


read modified 


vi 
' 
' 


6 -- read buffer 


write ctl char 
contains the low-order 6 bits of the write control character (WCC) 
to be inserted in the data stream. If command (above) is 3 (copy), 
this field contains the low-order 6 bits of the copy control 
character (CCC), except that the keyboard_restore and reset _mdt 
bits are replaced by the copy bits (below). 


copy_bits 
“contains the two low-order bits of the copy control character if 
command (above) is 3 (copy). These are the bits that specify 


what type of data is to be copied. 


max fields 
is the number of elements in the data array (below). 


max_len 
is the maximum length of any contents string (below). 


mod_ fields 


is the number of elements of the data array actually filled in in 
this instance of the structure. 


6-33 CC92-01 


ibm3270_ 


ibm3270_ 


data 
describes the individual data fields to be sent to the device, 


orders 
identify orders to be inserted in the output stream. 


set_buffer_addr 
indicates a set buffer address (SBA) order. The field position 
(below) contains the buffer address to be set. 


Start field 
indicates a start field (SF) order. The attribute character for 
the field is derived from attributes (below). If an SBA order is 
also indicated, the field starting address is contained in 
field position (below); otherwise, the current device buffer address 
is used. The contents string, if nonnull, is written starting 
after the attribute character. 


insert cursor 
indicates an insert cursor (IC) order. If an SBA order is also 
indicated, the cursor is positioned to the address specified in 
field position (below); otherwise it is set to the current device 
buffer address. If contents is nonnull, the datais written starting 
at the new cursor position. 


program tab 
indicates a program tab (PT) order. If an SBA order is also 
indicated, the tab is inserted at the address specified in 
field position (below); otherwise it is inserted at the current 
device buffer address. If contents is nonnull, the data is written 
at the start of the field following the tab. 


repeat _to_addr 
indicates a repeat to address (RA) order. The starting address 
is the current device buffer address; the ending address is specified 
in field position (below). Neither an SBA order nor an EUA order 
can be indicated in the same field. The contents string must 
consist of a single character, which is to be repeated up to the 
address immediately preceding field position. 


erase to addr 
indicates an erase unprotected to address (EUA) order. The starting 
address is the current device buffer address; the ending address 
is specified in field position (below). Neither an SBA order nor 
an RA order can be indicated in the same field. If contents is 
nonnull, the data is written starting at the address specified in 
field position. 


attributes 
contains the low-order 6 bits of the attribute character to be 
assigned to a field if start_field (above) is "1"b. 


field position 
is the device buffer address to be set if set buffer addr (above) 
is "1"b, or the ending address if repeat _to_addr or erase to addr 
(above) is "1"b, = 


contents 
is the data to be written. It may be a null string. 
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set_input_message size 
specifies the length, in characters, of the largest input message that 
is expected. The info ptr must point to a fixed binary number containing 
the message size. A size of 0 indicates. that there is no maximum 
message size. Use of this order when a maximum message size is defined 
greatly increases the efficiency of the channel. 


get_input_message size 
is used to obtain the maximum input message size. The info ptr must 
point to a fixed binary variable in which the maximum message size is 
returned as a result of the call. This size is the one most recently 
specified by .a set input message size order. If no 
set_input_message size order has been done since the switch was attached, 
a size of 0 is returned. 


Modes Operation 


This I/O module does not Support the modes operation. 
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Name: ibm3780_ 


The ibm3780__ I/O module performs stream I/O to a remote I/0 terminal that 
has the characteristics of an IBM 3780 data transmission terminal. The hardware 
options currently supported are defined by the control arguments described below. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


This module in turn constructs an attach description for the module specified 
in the -comm control argument, passing the attach information for ascii or ebcdic, 
tty, transparent or nontransparent, and all other attach information specified 
by the caller. 


Attach Description 
ibm3780  -control_args 


where control arguments may be chosen from the following and are optional, with 
the exception of -tty and -comm: 


-asecii 
transmits control information and data in ASCII. 


-ebcdic 
converts control information and data to its EBCDIC representation 
before transmission. This is the default. 


-multi_record 
transmits multiple records, up to 6, as a block, rather than separately. 
The default is single record transmission. 


-physical line length N, -pll N 
sets the maximum character width of the remote I/0 terminal printer 
to N characters. The default is 80 characters (120 if -device specifies 
printer). This variable is used to set tabs and pad records if the 
transparent option is specified. 


-horizontal_ tab, -htab 
supports tab control on the remote I/O terminal printer. Tabs are 
set every 10 spaces. The default is no tab control. 


-tty STR 
connects the remote I/O station to the communications channel named 
STR. 

-comm STR 


uses the communications I/O module specified by STR. 


-transparent 
uses a transparent communication protocol. 


-nontransparent 
uses a nontransparent communication protocol. This is the default. 
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-device STR 
specifies that this attachment is associated with the device STR. 


-carriage ctl STR 
the eight-character string STR, taken two characters at a time, sets 
the four carriage control characters which specify the advance of 0, 
1, 2, and 3 lines. The default set of characters is ESCM, ESC/, 
ESCS, and ESCT where the mnemonic ESC means the ASCII escape character. 


-~slew_ ctl STR . 
the six-character string STR, taken two characters at a time, sets 
the slew control. characters which specify top of form, inside page,. 
and outside page. The default set of characters is ESCA, ESCA, and 
ESCA. 


-printer_ select STR 
the one«character string STR sets the printer select. The default 
printer select string is DC1. 


-punch_ select STR 
the one-character string STR sets the punch select. The default 
punch select string is DC2. 


-terminal type STR, -ttp STR 
STR specifies the terminal type whose conversion, translation, and 
special tables defined in the user or system terminal type table 
(TTT) are used to convert and translate input and output to and from 
the device. Ifnot specified, no conversion or translation is performed. 
For more information about the allowable conversion values see "Notes" 
below. 


Open Operation 


The ibm3780  I/0 module supports stream_input, stream output, and 
stream input output opening modes. 


Put Chars Operation 


The put chars entry splits the data to be written into blocks of 80 or 512 
characters, depending on whether multirecord mode is enabled, and transmits the 
number of characters specified to the specified communication I/0 module. The 
blocks are of fixed or variable length, depending on whether transparent. mode is 
enabled or not, respectively. 


Get Chars Operation 


The get_chars entry reads characters up to 80 or 512 characters, depending 
on whether multirecord mode is enabled, and returns the number requested, up to 
the next record separator. 
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Control Operation 


This I/O module supports all the control operations supported by the 
communications I/O module specified in the attach description. In addition, it 
supports the following: 


set _bsc_modes 
sets the character mode, either ascii or ebcdic and transparency. The 
input structure is defined as follows: 


del 1 set_bsc_modes aligned, 
2 char_mode bit(1) unaligned, 
2 transparent bit(1) unaligned; 


where char_mode = "1"b if ebcdic and "O"b if ascii, and transparent = "1"b 
if transparency is enabled and "0"b if not. 


select: device 
selects the subdevice (either printer, punch, or teleprinter) to which 
output is next directed. The input structure is of the form: 
del device char(32) based; 


set_multi_record_mode 
sets the number of records per block. The input structure is of the 
form: 
del record_number fixed bin based; 


Modes Operation 


This module supports the nonedited and default modes, which set and reset 
the edited output conversion, if it has been enabled by the -terminal type control 
argument. 


Notes 


The only allowable values in the output conversion table are 00 and any 
values greater than 16. All values defined in the description of the tty I/0 
module are allowed for input conversion. Input and output translation may be up 
to 256 characters in length. 
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Name: remote _input_ 


The remote input I/0 module performs record input from a terminal I/0 
module which is assumed to be connected to a remote I/O device, such as a 
Honeywell Level 6 remote batch facility (G115 type), an IBM 2780, or an IBM 3780. 
Except for hardware restrictions, this module performs some code conversion and 
control in such a way that remote and local card reading are the same. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


This module in turn constructs an attach description for the module specified 
in the -terminal control argument, passing the other attach information specified 
by the caller. 


Attach Description 


remote input _ -control_args 
where control args may be chosen from the following: 


-terminal STR 
STR specifies the terminal I/0 module to be attached by this device 
I/O module. (required) 


-device STR 
STR defines the device type which this I/O module is attempting to 
simulate. The acceptable values for STR are reader, printer _in and 
punch in. This control argument is optional. If not supplied, a 
device type of reader is assumed. 


-runout spacing N, -runsp N 
This control argument is accepted and ignored for compatibility with 
other device=-level I/O modules. It is not passed on to the terminal 
I/O module. 


-physical_ line length N, -pll N 
This control argument is accepted and ignored for compatibility witn 
other device-level I/O modules. It is not passed on to the terminal 
I/O module. 


-record_len N 
defines the maximum record length (buffer size) for data from the 
terminal I/O module in characters. The accepted ranges are 80 to 
160 for the device type of reader, and 10 to 1024 otherwise. If 
this control argument is not given, the maximum for the device type 
is assumed. 


All other attach control arguments are assumed to belong to the terminal - 
I/O module. These are passed on as part of its attach description. The -device 
option passed on to the terminal I/O module will specify one of the following 
devices: reader, printer, or punch. See the description of the terminal I/0 
module for a full definition of required and optional control arguments. 
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Open Operation 


The remote input I/O module supports the stream_input opening mode. The 
terminal I/O module switch is in turn opened with the record input mode. 


Get Chars Operation 


The get_chars entry reads one record from the terminal I/O module and returns 
up to the number of specified characters. If the number of characters in the 
record is greater than the requested number, error_table $data_loss is returned 
along with the data. a 


Control Operation 


The remote_input_ device I/O module supports the following control operations: 


reset 
sets the current record count to 0 and passes the control operation on 
to the terminal I/O module. 


get count 
returns the current record count. This is the count of records read 
from the terminal I/0 module since the last reset control operation. 
This operation is not passed on to the terminal I/O module. 


The info pointer must point to the following structure. (This structure 


is taken from the counts structure in. prt_order_info.inel.pl1 for 
compatibility with procedures which use several device I/O modules.) 


del 1 counts aligned based, 
2 prt_data_ pad (4) fixed bin, 
2 record count fixed bin (35), 
2 prt_pad fixed bin; 
The variable record count will contain the returned value. This 
corresponds with the variable line count from the other structure. 


All other control operations are passed on to the terminal I/O module. 


Modes Operation 


This I/O module supports the modes defined by the terminal I/O module specified 
in the attach description. 
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Name: remote printer_ 


The remote printer I/O module presents a stream I/O interface to the caller 
and performs record output to a printer, which is assumed to be part of a remote 
I/O device, such as a Honeywell Level 6 remote batch facility (G115 type), an 
IBM 2780, or an IBM 3780. Except for hardware restrictions, this module performs 
all the necessary code conversion and control in such a way that remote and 
local printing are the same. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


This module in turn constructs an attach description for the module specified 
in the -terminal control argument, passing the attach information for horizontal 
tabbing, physical line length, and all other attach information specified by the 
caller. 


Attach Description 
remote printer. -control args 
where control_args are optional, with the exception of -terminal, and may be 
chosen from the following: 
-physical_ line length N, -pll N 
printer has a maximum line width of N characters. The default is 
132 characters. 
~physical_page length N, -ppl N 
printer has a maximum line count per page of N. The default is 66 


lines. 


-horizontal tab, -htab 
printer has a horizontal tab feature. The default is no tab control. 


-terminal STR 
uses the terminal I/O module specified by STR. This control argument 
is required. 


Open Operation 


The remote printer I/O module supports the stream_output opening mode. 
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Put Chars Operation 


The put_chars entry converts a character string delimited by a newline 
character to an image suitable for printing and transmits this image to the 
terminal I/0 module. This operation is repeated until all the characters specified 
by the caller have been transmitted. 


Control Operation 


This I/O module supports all the control operations supported by the terminal 
I/O module specified in the attach description. In addition, it supports all 
the printer control operations supported by the printer I/0 module prtdim (see 
Appendix B). . 


Modes Operation 


This I/O module supports all the modes supported by the terminal I/O module 
specified in the attach description. In addition, it supports all the modes 
supported by the printer I/O module prtdim_ (see Appendix B). It supports the 
two modes non edited and default, which enable and disable edited output conversion, 
if output conversion has been enabled by the terminal I/O module. 


Position Operation 


This I/O module supports all the position operations supported by the terminal 
I/O module specified in the attach description. 
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Name: remote _punch_ 


The remote _punch_ I/O module presents a stream I/O interface to the caller 
and performs record output to a card punch, which is assumed to be part of a 
remote I/O device, such as a Honeywell Level 6 remote batch facility (G115 type), 
an IBM 2780, or an IBM 3780. Except for hardware restrictions, this module 
performs ail the necessary code conversion and control in such a way that remote 
and local card punching are the same. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. 


This module in turn constructs an attach description for the module specified 
in the -terminal control argument, passing the other attach information specified 
by the caller. 


Attach Description 
remote punch_ -control_arg 


where control args may be chosen from the following: 


-terminal STR 
STR specifies the terminal I/0 module to be attached to this device 
I/O module. (Required) 

-device STR 
defines the type of device to be simulated by this I/O module and 
may be either "punch" or "reader simulator". This specification is 
passed to the terminal I/O module as "-device punch" or "-device 
reader", respectively. (Default is "“punch".) 


-card 11 N 
specifies the length of records (cards) supported by the terminal 
I/O module. (Default is 80.) 


-non_edited 
specifies that non-printing characters may be passed directly to the 
terminal I/O module. (Default is that these characters are not passed.) 


-horizontal tab, -htab 
specifies that the device supports the horizontal tab character. 
(Default is the use of the appropriate number of spaces.) 


-runout_ spacing N, -rnsp N 
-physical_page_ length N, -ppl N 


are accepted and ignored for compatibility with other device I/0 
modules. 


All other attach arguments are passed directly to the terminal I/O module. 
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Open Operation 


The remote punch I/O module supports the stream_output opening mode. 


Put Chars Operation 


The put_chars entry splits the data to be written into records of the size 


ana mawnmaemit TIN 


by -card 11 and transmits these records to the terminai 1/0 moduie. This 


operation is repeated until all the characters specified by the caller have been 
transmitted. 


Control Operation 


The remote punch device I/0 module supports the following control operations: 


sets the current record count to zero, returns to punching in RMCC 
(remote Multics card code), and passes the order to the terminal I/0 
module. 


get_count 


returns the current record count which is the number of records written 
to the terminal I/0 module since the last reset control operation. 
This operation is not passed on to the terminal I/O module. The info ptr 
must point to the following PL/1 structure. (This structure is taken 
from the counts structure in prt_order_info.incl.pl1 for compatibility 
with procedures which use several device I/0 modules.) 


del 1 counts aligned based, 
2 prt_data_pad (4) fixed bin, 
2 record count fixed bin (35), 
2 prt_pad fixed bin; 


The variable record count will contain the returned value. This 
corresponds with the variable line count from the other structure. 


binary_punch 


requests that all subsequent data be punched in binary (rather than 
RMCC) if supported by the terminal I/0 module. This control order is 
then passed on to the terminal I/O module. 


All other control operations are passed directly to the terminal I/O module 


for processing. 
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Modes Operation 


This I/O module supports the RMCC output card mode defined in Section V of 
the MPM Reference Guide. It also supports the two modes non edited and default, 
which enable and disable edited output conversion, if output conversion has been 
enabled by the terminal I/O module. 


Position Operation 


This I/O module supports all the position operations supported by the terminal 
I/O module specified in the attach description. 
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Name: remote teleprinter_ 


| The remote teleprinter_ I/O module presents a stream I/O interface to the 

caller and performs record I/O to a terminal or printer, which is assumed to be 

part of a remote I/O device, such as a Honeywell Level 6 remote batch facility 
(G115 type), an IBM 2780, or an IBM 3780. 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/0 system. 


This module in turn constructs an attach description for the module specified 
in the -terminal control argument, passing the attach information for ASCII or 
EBCDIC, horizontal tabbing, physical line length, and all other attach information 
specified by the caller. 


Attach Description 
remote teleprinter_ -control_ args 


where control args are optional, with the exception of -terminal, and may be 
chosen from the following: 


-physical line length N, -pll N 
output device has a maximum line width of N characters. The default 
is 80 characters. 


-physical page length N, -ppl N 
output device has a maximum line count per page of N. The default 
is 66 lines. 


-horizontal tab, -htab 


output device has a horizontal tab feature. The default is no tab 
control. 


-terminal STR 
uses the terminal I/O module specified by STR. This control_arg is 
required. 


-runout spacing N, -runsp N 
outputs N newline characters with each runout operation. This allows 
the operator to see messages still under the printer mechanism for 
terminals which have only a printer as an output device. The default 
is 0. 
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Open Operation 


The remote teleprinter_ I/0 module supports the stream_input_output opening 
mode. 


Put Chars Operation 


The put_chars entry converts a character string ending in a newline character 
to an image suitable for printing and transmits this image to the terminal I/0 
module. 


Get Chars Operation 


The get_chars entry reads the number of specified characters from the terminal 
I/O module. 


Get Line Operation 


The get_line entry reads one record from the terminal I/O module, appends a 
new line, and returns as many characters as requested by the caller, or the 
whole record if it is shorter. If the record is longer than requested, 
error table $data_loss is returned. 


Control Operation 


This I/O module supports all the control operations supported by the terminal 
I/O module specified in the attach description. In addition, it supports all 
the printer control operations supported by the printer I/O module prtdim_ (see 
Appendix B). 


Modes Operation 


This I/O module supports all the modes supported by the terminal I/O module 
specified in the attach description. In addition, it supports all the modes 
supported by the printer I/O module prtdim_ (see Appendix B). It also supports 
the two modes non edited and default, which enable and disable edited output 
conversion if output conversion has been enabled by the terminal I/O mod:le. 


Position Operation 
This I/0 module supports all the position operations supported by the terminal 


I/O module specified in the attach description. 
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Name: tty_ 


The tty I/O module supports I/0 from/to devices that can be operated in a 
typewriter-like manner, e.g., the user's terminal. 


Entry points in the module are not called directly by users; rather the 
module is accessed through the I/O system. See "Multics Input/Output System" in 
Section 5 of the MPM Reference Guide for a general description of the I/0 system. 


Attach Description 


tty {device} {-control args} 


where device is the channel name of the device to be attached (channel names are 
described in Appendix A). If a device is not given, the -login channel control 
argument must be given. The star convention is allowed. 


Control arguments may be chosen from the following: 


-login channel 

“specifies attachment to the user's primary login channel. If a device 
is not specified then the user's login channel is used. This control 
argument flags this switch for reconnection by the process disconnection 
facility. If the user's login device should hang up, this switch 
will be automatically closed, detached, attached and opened on the 
user's new login channel when the user reconnects, if permission to 
use this facility is specified in the SAT and PDT for the user. 


-destination DESTINATION 
this control argument specifies that the attached device is to be 
called using the address DESTINATION. In the case of telephone auto call 
lines, DESTINATION is the telephone number to be dialed. Use of 
this control argument requires the dialok attribute. 


-dial id STR 
~ specifies that dial connections are to be accepted on the dial id 
STR. Use of this control argument requires the dialok attribute. 
The dial command is then used to connect a terminal on the dial id 
STR. If STR is not a registered dial id, then the Person id.Project id 
of the process being connected to muSt be supplied to the dial command. 
For example: 


dial STR Person. Project 


To become a registered server, the process must have rw access to 
>seq>rep>dial.STR.acs. 
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-no block 
7 specifies that the device is to be managed asynchronously. tty 
will not block to wait for input to be available or output space to 
be available. (See "Buffering" below for more details.) This control 
argument should not be used on the login channel, because it will 
cause the command listener to loop calling get line. 


-no hangup on detach 
~ prevents the detach entrypoint from hanging up the device. This is 
not meaningful for the login channel. 


-hangup on detach 
causes the detach entrypoint to hang up the device automatically. 
This is not meaningful for the login channel. 


-resource STR 
specifies the desired characteristics of a channel. STR (which can 
be null) consists of reservation attributes separated by commas. 
The channel used by a dial-out operation must have the characteristics 
specified in the reservation string. Reservation attributes consist 
of a keyword and optional argument. Attributes allowed are: 


baud rate=BAUD RATE 
line type=LINE TYPE 


where BAUD RATE is a decimal representation of the desired channel 


line speed and LINE TYPE is a valid line type, chosen from 
line types.incl.pl1 (see set line type, below). 
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Notes 


The device specified must be available to the attaching process. The user's 
login device is always available. Any devices acquired with the dial manager 
subroutine are also available. If the device is in slave service, and the user 
has appropriate access to its access control segment (rw to >sc1>rep>NAME.acs), 
tty will attempt to make it available using the privileged attach mechanism of 
dial manager . If the -destination control argument is specified, the dial out 
mechanism is used (the user must have rw access to >sc1>rep>NAME.acs). If the 
-dial id control argument is specified, the allow dials or registered server 
mechanism is used. See the documentation of dial manager in the MPM Subsystem 
Writer's Guide for more details. a = 


Opening 


The opening modes supported are stream input, stream output, and 
stream input output. 


Editing 


On both input and output, data is automatically edited as described in 
"Typing Conventions" in Section 2. To control the editing, use the modes operation. 
Details on the various modes are given below. 


Buffering 


This I/O module will block to await either the availability of input characters 
or the availability of output buffer space, unless the -no block control argument 
is specified in the attach description. If the -no block attach description 
control argument is specified, the behavior of the iox $put chars, iox $get chars 
and iox $get line calls changes. If the put chars entrypoint cannot write all 
the characters supplied, it will return a nonstandard status code consisting of 
the negative of the number of characters actually written plus one (-(n chars written 
+1)). Any positive status code should be interpreted as a standard system status 
code. The get chars and get line entrypoints will return zero status codes and 
zero characters read if there is no input available. 


Interrupted Operations 


When an I/O operation (except detach) being performed on a switch attached 
by this I/O module is interrupted by a signal, other operations may be performed 
on the switch during the interruption. If the interrupted operation is get line, 
get chars or put chars, and another get line, get chars or put chars operation 
is performed during the interruption, the "start" control operation should be 
issued before the interrupted operation is resumed. 
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Get Chars Operation 


The get chars operation reads as many characters as are available, up to, 
but not exceeding, the number requested by the caller. No error code is returned 
if the number of characters read is less than the number requested. At least 
one character is always returned (unless the number requested is zero). The 
characters read may comprise only a partial input line, or may comprise several 
input lines; no assumptions can be made in this regard. 


Get Line Operation 


The get line operation is supported. No error code is returned if the read 
operation occurs with the input buffer length at zero. For further explanation, 
see the iox $get_line entry in MPM Subroutines. 


Put Chars Operation 


The put chars operation is supported. For further explanation, see the 
iox $put_chars entry in MPM Subroutines. 


Control Operation 


The following orders are supported when the I/O switch is open. Except as 
noted, the info ptr should be null. The orders are divided into categories. 
Local orders perform a specific function one time only; global orders change the 
way the system interfaces with the terminal; and other orders fit in neither 
category. Control orders are performed through the iox $control entry, as described 
in MPM Subroutines. 


LOCAL 
abort 
flushes the input and output buffers. 
interrupt 
sends an out-of-band interrupt signal (quit signal) to the terminal. 
resetread 
flushes the input buffer. 
resetwrite 
flushes the output buffer. 
hangup 


disconnects the telephone line connection of the terminal, if possible. 
This makes the terminal unavailable for further uSe. 
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listen 
sends a wakeup to the process once the line associated with this device 
identifier is dialed up. 


printer off 
causes the printer mechanism of the terminal to be temporarily disabled 
if it is physically possible for the terminal to do so; if it is not, 
the status code error table $action not performed is returned (see 
"Notes" below). a ~ ~~ 


printer on 
eauses the printer mechanism of the terminal to be reenabled (see 
"Notes" below). 


wru 
initiates the transmission of the answerback of the device, if it is 
so equipped. This operation is allowed only for the process that 
originally attached the device (generally the initializer process). 
The answerback may subsequently be read by means of the get chars 
input/output operation. = 


start xmit hd 
causes the channel to remain in a transmitting state at the completion 
of the next block of output, rather than starting to accept input. 
The line will then remain in a transmitting state until the stop xmit hd 
control operation is issued. This operation is valid only for terminals 
with line type LINE ARDS. 


stop xmit hd 
~eauses the channel to resume accepting input from the terminal (after 
the completion of current output, if any). This operation is only 
valid for ARDS-like terminals and is used only to counteract a preceding 
start xmit hd operation. 


GLOBAL 


set line type 
~ sets the line type associated with the terminal to the value supplied. 
The info ptr should point to a fixed binary variable containing the 
new line type. Line types can be any of the following named constants 
defined in the include file line types.incl.pl1: 


LINE ASCII 
“device similar to 7-bit ASCII using Bell 103-type modem protocol 


LINE 1050 
“device similar to IBM Model 1050 
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LINE 2741 
device similar to IBM Model 2741, with or without auto EOT inhibit 


LINE ARDS 


device similar to Adage, Inc. Advanced Remote Display Station 
(ARDS) protocol using Bell 202C6-type modem 


LINE SYNC 
“synchronous connections, no protocol 


LINE G115 
“ASCII synchronous connection, Model G-115 remote computer protocol 


LINE BSC 
“binary synchronous protocol 


LINE ETX 


“device Similar to TermiNet 1200 protocol using Bell 202C5-type 
modem 


LINE VIP 


“device similar to Honeywell Model 7700 Visual Information Projection 
(VIP) standalone terminal 


LINE ASYNC1 
LINE ASYNC2 
LINE ASYNC3 
“site-supplied asynchronous protocols 


LINE SYNC1 
LINE SYNC2 
LINE SYNC3 
~“site-supplied synchronous protocols 


LINE POLLED VIP 
“device similar to Honeywell Model 7700 Visual Projection System 
(VIP) polled terminal concentrator subsystem. 


LINE X25LAP 
~X.25 network connection using the link access protocol (LAP) 


LINE COLTS 
“special software channel used for Communications Online Test and 
Diagnostics System 


This operation is not permitted while the terminal is in use. 


refuse printer off 


causes subsequent printer off and printer _on orders to be rejected 
except when in echoplex mode. 


accept printer off 


causes subsequent printer off and printer on orders to be accepted if 
possible. = 
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set_delay 


sets the number of delay characters associated with the output of 
carriage-motion characters. The info ptr points to the following 
structure: (defined in tty convert.incl.pl11) 


dell delay struc based aligned, 
2 version fixed bin, 
2 default fixed bin, 
2 delay, 
3 vert_nl fixed bin, 
3 horz nl float bin, 
3 const_tab fixed bin, 
3 var_tab float bin, 
3 backspace fixed bin, 
3 vt fr fixed bin; 
where: 
version 


is the version number of the structure. It must be 1. 


default 

indicates, if nonzero, that the default values for the current 
terminal type and baud rate are to be used and that the remainder 
of the structure is to be ignored. 


vert nl 
“is the number of delay characters to be output for all newlines 
to allow for the linefeed (-127 < vert_nl < 127). If it is 
negative, its absolute value is the minimum number of characters 
that must be transmitted between two linefeeds (for a device such 
as a TermiNet 1200). 


horz nl 
“is a number to be multiplied by the column position to obtain the 
number of delays to be added for the carriage return portion of a 
newline (0 < horz nl < 1). The formula for calculating the number 
of delay characters to be output following a newline is: 
ndelayss= vert_nl+fixed(horz_n1*column) 


const_tab 
is the constant portion of the number of delays associated with 
any horizontal tab character (0 < const_tab < 127). 


var tab 
~ is the number of additional delays associated with a horizontal 
tab for each column traversed (0 < var tab < 1). The formula for 
calculating the number of delays to be output following a horizontal 
tab is: 
ndelays = const_tab + fixed (var_tab*n_columns) 
backspace 


is the number of delays to be output following a backspace character 
(-127 < backspace < 127). If it is negative, its absolute value 
is the number of delays to be output with the first backspace of 
a series only (or a single backspace). This is for terminals 
such as the TermiNet 300 which need delays to allow for hammer 
recovery in case of overstrikes, but do not require delays for 
the carriage motion associated with tne backspace itself. 
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get delay ’ 
is used to find out what delay values are currently in effect. The 
info ptr points to the structure described for set_delay (above), which 
is filled in as a result of the call (except for the version number, 
which must be supplied by the caller). 


set_editing chars 
changes the characters used for editing input. The info_ptr points to 
the following structure: 


del 1 editing chars aligned, 


2 version fixed bin, 
2 erase echar(1) unaligned, 
2-KE LI echar(1) unaligned; 
where: 
version 


is the version number of this structure. It must be 2. 


erase 
is the erase character. 


kill 
is the kill character. 


The following rules apply to editing characters: 
is The two editing characters may not be the same. 


2s No carriage-movement character (carriage return, newline, horizontal 
tab, backspace, vertical tab, or formfeed) may be used for either 
of the editing functions. 


36 NUL and space may not be used for either editing function. 


4, If either of the editing characters is an ASCII control character, 
it will not have the desired effect unless ctl_char mode is on 
(see "Modes Operation" below). 


get editing chars 
~ is used to find out what input editing characters are in effect. The 
info_ptr points to the structure described above for set_editing chars, 
which is filled in as a result of the call (except for the version 
number, which must be supplied by the caller). 
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input_translation 

provides a table to be used for translation of terminal input to ASCII. 
The info ptr points to a structure of the POLLOWEOS form: (defined in 
tty _eonvert.inecl.pl1} é 


del 1 ev_trans_strue aligned, 
2 version fixed bin,, 
2 default fixed bin, 
2 cv_trans aligned, 
3 value (0 : 255) char(1) unaligned; 
where: 
version 


is the version number of the structure. It must be 1. 


default 
indicates, if nonzero, that the default table for the current 
terminal type is to be used, and the remainder of the structure 
is ignored. 


values 
are the elements of the table. This table is indexed by the 
value of a typed input character, and the corresponding entry 
contains the ASCII character resulting from the translation. If 
the info ptr is null, no translation is to be done. 


NOTE: In the case of a terminal that inputs 6-bit characters and 
ease-shift characters, the first 64 characters of the table 
correspond to characters in lower shift, and the next 64 
correspond to characters in upper shift. 


set _output_translation 


provides a table to be used for translating ASCII characters to the 
eode to be sent to the terminal. The info ptr points to a structure 
like that described for set_input_translation (above). The table is 
indexed by the value of each ASCII character, and the corresponding 
entry contains the character to be output. If the info_ptr is null, 
no translation is to be done. 


NOTE: For a terminal that expects 6-bit characters and case-shift 
characters, the 400(8) bit must be turned on in each entry in 
the table for a character that requires upper shift and the 
200(8) bit must be on in each entry for a character that requires 
lower shift. 


set_input_conversion 


provides a table to be used in converting input to identify escape 
sequences and certain special characters. The info_ptr points to a 
structure of the following form: (defined in tty_ convert.incl.pl1) 


del 1 ev_trans_struc aligned, 


2 version fixed bin, 
2 default fixed bin, 
2 ev trans aligned, 
3 value (0 : 255) fixed bin(8) unaligned; 
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where version, default, and value are as described in the cv trans struc 
structure used with the set input translation order above. The table 
is indexed by the ASCII value of each input character (after translation, 
if any), and- the corresponding entry contains one of the following 
values: (Mnemonic names for these values are defined in 
tty_convert.incl.pl1i) 


-- ordinary character 

-- break character 

-- escape character 

character to be thrown away 

-- formfeed character (to be thrown away if page length is nonzero) 

-- this character and immediately following character to be thrown 
away 


WW FWNhN =o 
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set output conversion 
~ provides a table to be used in formatting output to identify certain 
kinds of special characters. The info ptr points to a structure like 
that described for set_input_ conversion (above). The table is indexed 
by each ASCII output character (before translation, if any), and the 
corresponding entry contains one of the following values: (Mnemonic 
names for these values are defined in tty_convert.incl.pl1) 


0 -- ordinary character 

1 -- newline 

2 -- carriage return 

3 -- horizontal tab 

4 -- backspace 

5 -- vertical tab 

6 -- formfeed 

7 -- character requiring octal escape 

8 -- red ribbon shift 

Q9Q -- black ribbon shift 

10 -- character does not change the column position 

11 -- this character together with the following one do not change the 
column position (used for hardware escape sequences) 

12 -- character is not to be sent to the terminal 

17 or greater -- a character requiring a special escape sequence. The 
indicator value is the index into the escape table of the sequence 
to be used, plus 16. The escape table is part of the special 


characters table; see the set special order below. 


get input translation 

get output translation 

get input_conversion 

get output_conversion 

~ These orders are used to obtain the current contents of the specified 

table. The info ptr points to a structure like the one described for 
the corresponding "set" order above, which is filled in as a result of 
the call (except for the version number, which must be supplied by the 
caller). If the specified table does not exist (no translation or 
eonversion is required), the status code error table $no table is 
returned. ~ 7 3 
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provides a table that specifies sequences to be substituted for eehtaia 


output characters, and characters that are to be interpreted as parts 
of escape sequences on input. Output sequences are of the following 
form: (defined in tty_convert_incl.pl1) | 
del 1 ec chars based aligned, 
2 count fixed bin(8) unaligned, 
2 chars(3) char(1) unaligned; 


where: 


count 


is the actual length of the sequence in characters 


If count is zero, there is no sequence. 


chars 


(O<count<3). 


are the characters that make up the sequence. 


The info_ptr points to a structure of the following form: 


tty_ convert __ inel.pl1) 


del 1 


2 
2 
2 


special chars struc 


version 
default 
special chars 
3 nl_seq 
3 er_seq 
3 bs_seq 
3 tab seq 
3 vt_seq 
3s ff seq 
3 printer_on 
3 printer off 
3 red ribbon shift 
3 black ribbon _ shift 
3 end of page 
3 escape length 
3 not_edited_escapes 
3 edited_escapes 
3 input_escapes 
4 len 
4 str 
3 input_results 
4 pad 
4 str 
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aligned 


(defined in 


aligned based, 
fixed bin, 
fixed bin, 


like 
like 
like 
like 
like 
like 
like 
like 


Zlen 


like 


aligned 
aligned 


e_ chars, 
Cc ehars,; 
e chars, 
e chars, - 
e chars, 
e_ chars, 
e chars, 
e chars, 
ce chars, 
e chars, 
e_chars, 


aligned 
aligned 
aligned 
aligned 
aligned 
aligned 
aligned like 
aligned like 
fixed bin, 
(se_escape_ len refer 
(special chars.escape length)) 
like ec _chars, 
(se_escape len refer 
(special _chars.escape_length)) 
like ec _chars, 
aligned, 
fixed bin(8) unaligned, 
char (se input _escape len refer 
(special_chars.input_escapes.len)) 
unaligned, 
aligned, 
bit(9) unaligned, 


“char (se input -eseape. len refer 


(special_chars.input_escapes.len) ) 
unaligned; 
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where: 


version 
is the version number of this structure. It must be 1. 


default 
is as above in set_input_translation. 


nl_seq 
is the output character sequence to be substituted for a newline 
character. The nl_seq.count generally should be nonzero. 


er seq 
is the output character sequence to be substituted for a 
earriage-return character. If count is zero, the appropriate number 
of backspaces is substituted. Either cr seq.count or bs seq.count 
(below), however, should be nonzero (i.e., both should not be 
zero). 


bs seq 
~ is the output character sequence to be substituted for a backspace 
character. If count is zero, a carriage return and the appropriate 
number of spaces are substituted. Either bs_seq-count or 
er seq.count (above), however, should be nonzero (i.e., both should 
not be zero). 


tab_seq 
is the output character sequence to be substituted for a horizontal 
tab. If count is zero, the appropriate number of spaces is 
substituted. 


vt seq 
~ is the output character sequence to be substituted for a vertical 
tab. If count is zero, no characters are substituted. 


ff seq 
~ is the output character sequence to be substituted for a formfeed. 
If count is zero, no characters are substituted. 


printer on 
is the character sequence to be used to implement the printer_on 
control operation. If count is zero, the function is not performed. 


printer off 
is the character sequence to be used to implement the printer off 
control operation. If count is zero, the function is not performed. 


red_ribbon_shift 


is the character sequence to be substituted for a red ribbon-shift 
character. If count is zero, no characters are substituted. 
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black_ribbon_shift 
is the character sequence to be substituted for a black ribbon-shift 
eharacter. If count is zero, no characters are substituted. 


end_of page 
is the character sequence to be printed to indicate that a page 
of output is full. If count is zero, no additional characters 
are printed and the cursor is left at the end of the last line. 


escape length 
is the number of output escape sequences in each of the two escape 
arrays. 


not _edited_escapes 
is an array of escape sequences to be substituted for particular 
characters if the terminal is in "“edited" mode. MThis array is 
indexed according to the indicator found in the corresponding 
output conversion table (see the description of the 
set_output_conversion order above). 


edited escapes 
is an array of escape sequences to be used in edited mode. [It is 
indexed in the same fashion as not_edited escapes. 


input escapes 
is a string of characters each of which forms an escape sequence 
when preceded by an escape character (see the discussion of escape 
sequences in Section 2 for more detailed information). 


input results 
is a string of characters each of which is to replace the escape 
sequence consisting of an escape character and the character 
occupying the corresponding position in input_escapes (above). 


snecial : 
actt) “al 


~ is used to obtain the contents of the special_chars table currently in 


use. The info_ptr points to the following structure (defined in 
tty_convert.incl.pl1): 


del 1 get_special_info_struc aligned, 
2 area ptr ptr, 
2 table ptr pErs 
where: 
area ptr (Input ) 
points to an area in which a copy of the current special chars 


table is returned. 


table ptr (Out put ) 
is set to the address of the returned copy of the table. 
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~ sets the terminal type associated with the channel to one of the types 


defined in the terminal type table. The info ptr should point to the 
following structure: 


del 1 set_term_type_info aligned, 
2 version fixed bin, 
2 name char(32) unaligned, 
2 flags, 
3 initial_string bit(1) unaligned, 
3 modes bit(1) unaligned, 
3 ignore _line_ type bit(1) unaligned, 
3 mbz bit (33); 
where: 
version 


is the version number of the above structure. It must be 1. 


name 
is the name of the terminal type to be set. 


initial_string 
is "i"b if the initial string for the terminal type is to be 
transmitted to the terminal; otherwise, it is "O"b. 


modes 
is "1"b if the default modes for the terminal type are to be set; 
otherwise it is "O"b. 


ignore line type 
is "1"b if the terminal type to be set need not be compatible 
with the line type; otherwise it is "O"b. 


mbz 
must be "0O"b. 


set framing chars 


specifies the pair of characters that the terminal generates surrounding 
input transmitted as a block or "frame". These characters must be 
specified in the character code used by the terminal. This order must 
be used for blk xfer mode (see below) to be effective. The info ptr 
must point to a structure with the following format: im 


del 1 framing chars aligned, 
2 frame begin char(1) unaligned, 
2 frame _end char(1) unaligned; 


get framing chars 


causes the framing characters currently in use to be returned (see the 
set_framing chars order, above). If no framing characters have been 
supplied, NUL characters are returned. The info_ptr must point to a 
structure like the one described for the set framing chars order; this 
structure is filled in as a result of the call. 
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set_wakeup_ table 


specifies a wakeup table, i.e. a set of wakeup characters, that controls 
the dispatching of input wakeups. The wakeup table operates in conjunction 
with wake tbl mode. The wakeup table has no effect until wake tbl 
mode is enabled. Once enabled, the standard method of generating input 
wakeups (normally one wakeup for each line) is suspended. Thereafter, 
wakeups are only generated when wakeup characters are received or when 
the buffer gets too full. The wakeup table cannot be changed while 
wake tbl mode is enabled. The info_ptr should point to the following 
structure: 


del 1 set wakeup table info aligned, 
2 version fixed bin, 
2 new table, 
3 new_wake map (0:127) bit(1) unal, 
3 mbz1 bit(16) unal, 
2 old table, 
3 old_wake_ map (Os 7127) bitC 1) -unal, 
3 mbz2 bit(16) unal; 
where: 
version (Input ) 


is the version number of this structure. It must be 1. 


new wake map (Input ) 
~ is an array having one entry for each character in the ASCII 
character set. A value of "1"b defines a wakeup character. All 
other entries must be "O"b. If all entries are "0"b, the current 
wakeup table, if any, is deleted. 


mbz1 (Input) 
must be "O"b. 


old_wake_map (Output ) 
is set to the value of the current wakeup table that is being 
replaced. If no current wakeup table exists, all entries are set 
tO..." OF" DB’. 


mbz2 (Output ) 
is set to "0O"b. 


The primary application for the wakeup table mechanism will be to 
reduce overhead incurred by text editors, such as gedx, while in input 
mode. While in input mode, a user process must wake up for each line 
of input even though no processing is immediately required. In wake tbl 
mode, a process will only be awoken when input mode is exited or a 
large amount of input has been accumulated. However, since wake tbl 
mode will cause more input to be buffered in ring 0 than before, a 
quit signal is likely to discard more input than before. If a user 
does not wish to lose input, he simply should avoid quitting while in 


5 A 
input mode. 


If a user does quit out of input mode, he will not remain in wake tbl 
mode (under normal circumstances). The default modes established by 
the standard quit handler include “wake tbl. A start command will 
restore wake tbl mode. 
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input_flow_control_ chars 
specifies the character(s) to be used for input flow control for terminals 
with line speed input capability. The terminal must be in iflow mode 
for the feature to take effect. (See the discussion of flow control 


in Section 2.) The info _ptr must point toa structure with the following 
format: 


del 1 input _flow_control_ info aligned, 


2 suspend_seq unaligned, 
3 count fixed bin(9) unsigned, 
3 chars char(3), 

2 resume seq unaligned, 
3 count fixed bin(9) unsigned, 
3 chars char (3), 

2 timeout bite 10s 


where: 


suspend seq 
is the character sequence that the system sends to tell the terminal 
to stop sending input, or that the terminal sends to inform the 
host that it is suspending input. count is an integer from 0 to 
3 that specifies the number of characters in the sequence. chars 
are the characters themselves. At present, only sequences of 
length O or 1 are supported. 


resume seq 
is the character sequence to be sent by the system to the terminal 
to tell it to resume transmission of input. count and chars are 
as above. 


timeout 
is "1"b if the resume character is to be sent to the terminal 
after input has ceased for one second, whether or not a suspend 
character has been received. 


output_flow_control_ chars 
enables either of two output flow control protocols and specifies the 
characters to be used for output flow control. The terminal must be 
in oflow mode for the feature to take effect. (See the discussion of 
flow control in Section 2.) The info ptr must point to a structure 
with the following format: 


del 1 output_flow_control_info aligned, 


2 flags unaligned, 
3 suspend resume bait C1) 5 
3 block acknowledge bit(1), 
3 mbz BiEC1E); 
2 buffer size fixed bin(18) unsigned unaligned, 
2 suspend or_etb_seq unaligned, 
3 count fixed bin(9) unsigned, 
3 chars char(3), 
2 resume_or_ack_seq unaligned, 
3 count fixed bin(9) unsigned, 
3 chars char(3); 


where: 


suspend resume 
is "1"b to specify a suspend/resume protocol. 
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block acknowledge 
is "1"b to specify a block acknowledgement protocol. 


buffer size 
is the number of characters in the terminal's buffer if 
block acknowledge is "1"b. Otherwise it is ignored. 


suspend or etb seq 
is the character sequence sent by the terminal to tell the system 
to suspend output if suspend resume is "1"b, or the end of block 
character sequence if block acknowledge is "1"b. count and chars 
are as described for the input flow control chars order above. 


resume or ack seq 
is the character sequence sent by the terminal to indicate that 
output may be resumed if suspend resume is "1"b, or the character 
sequence sent by the terminal to acknowledge completion of a block 
if block acknowledge is "1"b. count and chars are as above. 


get ifc info 


causes the characters currently in use for input flow control to be 
returned (see the input flow control chars order, above). The info ptr 
must point to a structure like the one described for the 
input flow control chars order, which will be filled in as a result of 
the call. If no characters are currently set, the count fields are 
set to 0. 


get ofc info 


causes the characters and protocol currently in use for output flow 
control to be returned (see the output flow control chars order, above). 
The info ptr must point to a structure like the one described for the 
output flow control chars order, which will be filled in as a result 
of the call. If no output flow control protocol is currently in use, 
the count fields are set to 0 and both suspend resume and block acknowledge 
are set to "0O"b. = = 


get channel info 


returns the name of the attached channel and its hardcore device index. 
The info ptr must point to the following structure (defined in 
tty get channel info.incel.pl1): 


del 1 tty get channel info aligned based, 
2 version | ~ fixed bin, 
2 devx fixed bin, 
2 channel name char (32); 
where: 
Ve version (Input) 
is the version of this structure. It must be set to 


2. devx 


tty get channel info version. 


(Output) 
is the hardcore device index for the channel. 


3% channel name (Output) 


7/82 


Is the name of the channel. 


6-63 CC92-01A 


tty tty 


OTHER 


read status 
“tells whether or not there is any type-ahead input waiting for a process 
to read. The info ptr should point to the following structure, (defined 
in tty read status info.incl.pl1) which is filled in by the call: 


del 1 tty read status info aligned based, 
2 event channel fixed bin (71), 
2 input pending bit (1); 
where: = 


ev chan 
~ is the event channel used to signal the arrival of input. 


input available 
indicates whether input is available. 
"O"b no input 
"7"5 anput 


write status 
Eells whether or not there is any write-behind output that has not 
been sent to the terminal. The info ptr should point to the following 
structure, which is filled in by the call: 


del 1 info structure aligned, 
2 ev chan fixed bin(71), 
2 output pending bit(1); 


where: 


ev chan 
~ is the event channel used to signal the completion of output. 


output pending 
indicates whether output is pending. 
"O"b no output 
"1"b output 


quit enable 
“eauses quit signal processing to be enabled for this device. (Quit 
Signal processing is initially disabled.) 


quit disable 
“eauses quit signal processing to be disabied for this device. 


start 
causes a wakeup to be signalled on the event channel associated with 
this device. This request is used to restart processing on a device 
whose wakeups may have been lost or discarded. 


store id 
Stores the answerback identifier of the terminal for later use by the 
process. The info ptr should point to a char(4) variable that contains 
the new identifier. 
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terminal info 


returns information about the terminal. The info ptr should point to 
the following structure: a 


del 1 terminal info aligned, 
2 version fixed bin, 
2 id char(4) unaligned, 
2 term type char(32) unaligned, 
2 line type fixed bin, 
2 baud rate fixed bin, 
2 reserved (4) fixed bin; 
where: 
version (Input) 


is the version number of the above structure. It must be 1. 


id (Output) 
is the terminal identifier derived from the answerback. 


term type (Output) 
“is the terminal type name. 


line type (Output) 
“is the line type number. 


baud rate (Output) 
“is the baud rate at which the terminal is running. 


reserved 
is reserved for future uSe. 


send initial string 
“transmits an initialization string to the terminal in raw output (rawo) 


mode. Due to the use of raw output mode, the string must comprise 
character codes recognized by the terminal. If the info ptr is null, 
the initial string defined for the terminal type is used. Otherwise, 
the info ptr should point to the following structure: 


del 1 send initial string info aligned, 
2 version ~ fixed bin, 
2 initial string ehar(512) varying; 
where: 
version 


is the version number of the above structure. It must be 1. 


initial string 
is the initial string to be sent. 


set default modes 


sets the modes to the default modes for the terminal type. 


Set event channel 


specifies the ipe event channel that will receive wakeups for this 
attachment. Wakeups are received for input availablie, output completed, 
and state changes such as hangups and quits. The channel may be event 
wait or event call. If it is event call, the -no block control argument 
must be present in the attach description for correct operation. 
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The info pointer should point to a fixed bin (71) aligned quantity 
containing a valid ipe channel identifier. No check for the validity 
of the channel is made. If the channel is invalid, incorrect operation 
will resuit. 


If this control order is not given before the opening of the switch, 
tty will attempt to allocate a fast event channel. Fast event channels 
may not be converted to call channels and receive no associated message. 
If tty cannot allocate a fast channel, an ordinary event wait channel 
will be created and used. This control order is accepted while the 
Switch is closed or open. If the switch is open, the new channel 
replaces the old one. 


get event channel 


returns the identifier of the ipe event channel associated with the 
channel. The info pointer should point to a fixed bin (71) aligned 
quantity into which the channel identifier will be stored. If the 
Switch is not yet open and the set event channel order has not been 
given, the result will be zero. - ys 


This control order, which replaces the event info control order, is 
accepted with the switch open or closed. For more information on 
event management, see the set event channel control order. 


copy meters 
~“eauses the current cumulative meters associated with the channel to be 


copied to unwired storage, so that the statistics for the channel can 
be determined both for the life of the system and for the current 
dialup. This order can only be issued by the "owning" process (normally 
the initializer). The info ptr should be null. 


get meters 


causes current values of meters associated with the channel to be 
returned. The info ptr must point to a structure of the following 
form, defined in the include file get comm meters info.inel.pl1: 
del 1 get comm meters info aligned based, 
2 version fixed bin, 
2 pad fixed bin, 
2 subchan ptr pointer, 
2 logical chan ptr pointer, 
2 parent ptr pointer, 
2 subchan type fixed bin, 
2 parent type fixed bin; 


where: 


version (Input) 
must be 1. 


subchan ptr (Input) 
is a pointer to a structure in which multiplexer-specific meters 
kept at the subchannel level are to be returned. The format of 
this structure depends on the channel type as specified by 
subchan type (see below). If no meters are kept for this channel 
type, then subchan ptr may be null. 
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logical_chan_ptr (Input) 
is a pointer to a structure in which logical channel meters (those 
maintained for every logical channel) are to be returned. This 
structure has the following form: 


del 1 logical _chan_meters based aligned, 
2 current _meters like lcte.meters, 
2 saved _meters like lcte.meters; 


where: 


current_meters 
contains the current values of the logical channel meters. 


The format of lete.meters is described by lct.incl.pli. 


saved_ meters 
contains the values of logieal channel meters the last time 
a copy_meters order was issued. 


parent ptr (Input ) ae 
is a pointer to a structure in which multiplexer-specific meters 
maintained by the channel's parent multiplexer are to be returned. 
The format of this structure depends on the channel type as specified 
by parent_type (see below). 


subchan_type (Output) 
is the channel type of the channel. It may have any of the 
values described in multiplexer _types.incl.pli. 


parent type (Output ) 
is the channel type of the channel's parent multiplexer. It may 
have any of the values described in multiplexer types.incl.pll. 


Modes Operation 


The modes operation is supported when the I/O switch is open. The recognized 
modes are listed below. Some modes have a complement indicated by the circumflex 
character (*) that turns the mode off (e.g., “erkl). For these modes the complement 
is displayed with the mode. Normal defaults are indicated for those modes that 
are generally independent of terminal type. The modes string is processed from 
left to right. Thus, if two or more contradictory modes appear within the same 
modes string, the rightmost mode prevails. 


obit. “Sbit 
causes input characters to be received without removing the 8th 
(high-order) bit, which is normally interpreted as a parity bit. This 
mode is valid for HSLA channels only. (Default is off.) 


blk xfer, “blk xfer 
~ specifies that the user's terminal is capable of transmitting a block 
or "frame" of input all at once in response to a single keystroke. 
The system may not handle such input correctly unless blk _ xfei mode is 
on and the set_framing chars order has seen issued. (Default is off.) 
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breakall, *“breakall 
enables a mode in which all characters are assumed to be break characters, 
making each character available to the user process as soon as it is 
typed. This mode only affects get chars operations. (Default is off.) 


can, “can 
performs standard canonicalization on input. (Default is on.) 


can _typezoverstrike, can_type=replace 
specifies the method to be used to convert an input string to canonical 
form. Canonicalization is only performed when the I/0 switch is in 
"can" mode. (Default is can_type=overstrike.) 


capo, “capo 
outputs all lowercase letters in uppercase. If edited mode is on, 
uppercase letters are printed normally; if edited mode is off and capo 
mode is on, uppercase letters are preceded by an escape (\) character. 
(Default is off.) 


erecho, “~crecho 
echoes a carriage return when a line feed is typed. This mode can 
only be used with terminals and line types capable of receiving and 
transmitting simultaneously. 


etl char, “etl char 
~ specifies that ASCII control characters that do not cause carriage or 
paper motion are to be accepted as input, except for the NUL character. 
If the mode is off, all such characters are discarded. (Default is 
off.) 


default 
is a shorthand way of specifying erkl, can, “rawi, “rawo, “wake tbl, 
and ese. The settings for other modes are not affected. 


echoplex, “echoplex 
echoes all characters typed on the terminal. The same restriction 
applies as for crecho; it must also be possible to disable the terminal's 
local copy function. 


edited, “edited 
suppresses printing of characters for which there is no defined Multics 
equivalent on the device referenced. If edited mode is off, the 9-bit 
octal representation of the character is printed. (Default is off.) 


erkl, “erkl 
performs "erase" and "kill" processing on input. (Default is on.) 


ese, “esc 


enables escape processing (see "Typing Conventions" in Section 2) on 
all input read from the device. (Default is on.) 
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force 
specifies that if the modes string contains unrecognized or invalid 
modes, they are to be ignored and any valid modes are to be set. If 
force is not specified, invalid modes cause an error code to be returned, 
and no modes are set. 


fulldpx, “fulldpx 
allows the terminal to receive and transmit simultaneously. This mode 
should be explicitly enabled before enabling echoplex mode. 


hndlquit, “hndlquit 
echoes a newline character and performs a resetread of the associated 
stream when a quit signal is detected. (Default is on.) 


iflow, “iflow 
specifies that input flow control characters are to be recognized and/or 
sent to the terminal. The characters must be set before iflow mode 
can be turned on. 


init 
sets all switch type modes off, sets line length to 50, and sets page 
length to zero. 


lfecho, *~lfecho 
echoes and inserts a line feed in the user's input stream when a 
carriage return is typed. The same restriction applies as for crecho. 


TAgig 7 del: 
~ gpecifies the length in character positions of a terminal line. If an 
attempt is made to output a line longer than this length, the excess 
characters are placed on the next line. If “ll is specified, line 
length checking is disabled. In this case, if a line of more than 255 
column positions is output by a single call to iox_$put_chars, some 


extra white space may appear on the terminal. 


no _outp, “no_outp 
causes output characters to be sent to the terminal without the addition 
of parity bits. If this mode and rawo mode are on, any 8-bit pattern 
can be sent to the terminal. This mode is valid for HSLA channels 
only. (Default is off.) 


oddp, “oddp 
causes any parity generation that is done to the channel to assume odd 
parity. Otherwise, even parity is assumed for line types other than 
2741 and 1050. This mode is valid for HSLA channels only. (Default 
is off.) 


oflow, “oflow 
specifies that output flow control characters are to be recognized 
when sent by tne terminal. The characters and the protocol to be used 
must be set before oflow mode can be turned on. 
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pin, “pl 

Specifies the length in lines of a page. When an attempt is made to 
exceed this length, a warning message is printed. When the user types 
a formfeed or newline character (any break character), the output continues 
with the next page. The warning message is normally the string "EOP", 
but can be changed by means of the set special control order. The 
string is displayed on a new line after n consecutive output lines are 
sent to the screen (including long lines which are folded as more than 
one output line). To have the end-of-page string displayed on the 
screen without scrolling lines off the top, n should be set to one 
less than the page length capability of the screen, unless the end-of-page 
string is a null string. In this case, output stops at the end of the 
last line of the page or screen. If “pl is specified, end-of-page 
checking is disabled. (See description of scroll mode below.) 


polite, “polite 
does not print output sent to the terminal while the user is typing 
input until the carriage is at the left margin, unless the user allows 
30 seconds to pass without typing a newline. (Default is off.) 


prefixnl, “prefixnl 
controls what happens when terminal output interrupts a partially complete 
input line. In prefixnl mode, a newline character is inserted in 
order to start the output at the left margin; in “prefixnl mode, the 
output starts in the current column position. (Default is on.) Polite 
mode controls when input may be interrupted by output; prefixnl controls 
what happens when such an interruption occurs. 


rawil, “rawi 
reads the data specified from the device directly without any conversion 
or processing. (Default is off.) 


rawo, ~rawo 
writes data to the device directly without any conversion or processing. 
(Default is off.) 


red, “red 
sends red and black shifts to the terminal. 


replay, “replay 
prints any partial input line that is interrupted by output at the 
conclusion of the output, and leaves the carriage in the same position 
as when the interruption occurred. (Default is off.) 


scroll, “scroll 
Specifies that end-of-page checking is performed in a manner suited to 
scrolling video terminals. If the mode is on, the end-of-page condition 
occurs only when a full page of output is displayed without intervening 
input lines. The mode is ignored whenever end-of-page checking is 
disabled. (Default is off.) 


tabecho, “tabecho 
echoes the appropriate number of Spaces when a horizontal tab is typed. 
The same restriction applies as for crecho. 


tabs, “tabs 
inserts tabs in output in place of spaces when appropriate. If tabs 
mode is off, all tab characters are mapped into the appropriate number 
of spaces. 
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vertsp, “vertsp 
performs the vertical tab and formfeed functions, and sends appropriate 
characters to the device. Otherwise, such characters are escaped. 
(Default is off.) 


wake tbl, “wake tbl 
“eauses input wakeups to occur only when specified wakeup characters 
are received. Wakeup characters are defined by the set wakeup table 
order. This mode cannot be set unless a wakeup table has been previously 
defined. 


Notes 


The status code error table $action not performed is returned by the printer on 
and printer off control operations if the special characters table currently in 
effect indicates that this terminal cannot perform the printer on or printer off 
operation. The Status code error table $no table is returned by the 
get input translation, get output translation, get input conversion, 
get output conversion, and get special control orders if the specified table 
does not exist. A code of zero is returned otherwise. 


To assist the user in determining how to alter the tables described above, 
the following paragraphs provide a summary of the processing of input and output 
strings in ring 0. 


INPUT PROCESSING 


1 Translation 
The characters are translated from the terminal's code to ASCII, using 
the input translation table. If there is no input translation table, 


this step is omitted. 


Bs Canonicalization 
The input string is rearranged (if necessary) into canonical form as 
described in Section 2. 


3% Editing 
Performs erase and kill processing as described in Section 2. 


4, Break and escape processing 
The characters in the input string are looked up in the input conversion 
table and treated accordingly. If a character is preceded by an escape 
character (as determined from the table) it is looked up in the 
input escapes array in the special chars table, and, if found, replaced 
by the corresponding character from the input results array. 


OUTPUT PROCESSING 


Ts Capitalization 
Lowercase letters are replaced by uppercase for terminals in “capo" 
mode; uppercase letters are prefixed by escape characters if appropriate. 
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Formatting 
The characters in the output string are looked up in the output_conversion 
table described above. Carriage-movement characters are replaced by 


sequences found in the special chars table, followed by delay characters 
if so indicated by the delay table. Ribbon-shift characters are likewise 
replaced by appropriate sequences. Any character whose indicator in 
the output conversion table is greater than 16 is replaced by the 
(indicator-16)th sequence in either the not edited escapes or 
edited escapes array in the special_chars table. ~— 7 


Translation 

The result of step 2 is translated from ASCII to the terminal's code, 
using the output_translation table. If there is no output_translation 
table, this step is omitted. ~ 


Control Operations from Command Level 


| SR 


Some control operations may be performed from the io call command, as follows: 


io_call control switch_name order_arg where: 


1. switch name 


“is the name of the I/O switch. 


2s order_arg 


can be any control order described above under "Control Operation" 
that can accept a null info ptr, as well as read_status, write status, 
terminal info, and the following (which must be specified as shown): 


store id id 
where id is the new answerback string. 


set_term_type type {-control_ args} 
where type is the new terminal type and -control_args may be 
any of -initial_ string (-istr), -modes, and -ignore line type. 


set line type line type 
where line _type is the new line type. 


line length N 
where N is the new line length. 


The following control orders can be used as active functions: 


[io_call control switch_name read status ] 


returns true if input is available; otherwise, false. 


omy call control switch name write status] 


returns true if output is pending; otherwise, false. 
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[io call control switch name terminal info terminal_type] 
“~ returns the current terminal type. 


[io call control switch name terminal info baud ] 
returns the baud rate... 


[io call eontrol switch_name terminal info id] 
returns the terminal identifier Canswerback). 


[io_call control switch_name terminal info line type] 
returns the current line type. 
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Name: tty_printer_ 


The tty_printer I/O module performs stream I/0 to a standard terminal 
(e.g., TN1200, ROSY, Diablo, VIP7760, or IBM3270 printer) to make it operate as 
a remote printer. The hardware options currently supported are defined by the 
control arguments described below. 


The tty printer  I/0 module can also be used to direct its stream I/0 
through the syn _ I/O module to another I/O switch (e.g., user_i/o or to a file 
switch through vfile_). 


Entry points in this module are not called directly by users; rather, the 
module is accessed through the I/O system. It is normally attached through the 
remote printer_ I/O module and all attach options are passed through remote printer __ 
to tty printer . 


Attach Description 
tty _printer_ -control_args 


where control arguments may be chosen from the following and are optional with 
the exception of -device, -tty, and -comm: 


-device STR 
attaches the switch as the device type specified by STR. STR is 
normally printer or teleprinter. 


-auto_call N 
specifies the phone number, N, to be called via the automatic call 
unit on the specified communications channel. 


-tty STR 
defines the target communications channel to be STR, where STR is an 
I/O switch name if the communications I/O module is syn_. 


-comm STR 
uses the communications I/O module specified by STR. Normally, STR 
is either tty_ or syn_. 


~physical_line_length N, -pllN 
specifies the physical line length, N, of the output device. 


-terminal type STR, -ttp STR 
STR specifies the terminal type whose conversion, translation, and 
special tables defined in the user or system terminal type table 
(TTT) are used to convert and translate input and output to and from 
the device. If not specified, the default terminal type is used. 


-horizontal_tab, -htab 
specifies that horizontal tab characters are to be sent to the device. 


-vtab 
specifies that vertical tab characters are to be sent to the device. 
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Open Operation 


The tty printer _ I/O module supports stream_input, stream output, and 
stream _input_output opening modes. 


Put Chars Operation 


The put_chars entry passes the data directly to the communications I/0 
module without any conversion. 


Get Chars/Get Line Operation 


The get_chars and get _line entries pass the operation directly to the 
communications I/O module. : 


Control Operation 


This I/O module passes all undefined control operations to the communications 
I/O module. In addition, it supports the control operations listed below. 
Unless otherwise specified, there are no input control structures. 


select _device 
selects the device characteristics for which output is next dir 
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option at attachment. The input structure is of the form: 


ja 
Lt 


del device char(32); 


runout 
transmits any data stored in the output buffer. 


hangup proc 
sets up a specified event call channel to be signalled over, and a 
procedure to be called, if the communications channel hangs up. The 
hangup proc input structure has the following form: 


del 1 hangup _proc aligned, 


2 entry entry variable, 
2 datap ptr, 
2° prior fixed bin; 
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where: 


entry 
is the entry to call when a hangup is detected. 


datap 
is a pointer to data for the hangup procedure. 


prior 
is the ipe_ event call priority to be associated with hangup 
notification. 


reset 
sets the “edited mode of output conversion and enables the tabs and 
vertsp modes if required by attachment options. 


get_error_ count 
returns the current count of errors detected since attachment. The 
input structure is of the form: 


del error_count fixed bin; 
hangup 
is used to hang up the device communications connection. This control 


operation is trapped if the communications I/O module is syn_, otherwise 
it is passed on. 


Modes Operation 


This I/O module passes all modes operations to the communications I/0 module. 


Notes 


This I/O module is normally attached through a remote device I/O module 
(e.g. remote printer_ or remote _teleprinter_.) Attachment to tty_printer_ is 
specified in the remote_device attach description by "-terminal tty_printer_" 
along with any attach options listed above. The -device attach option is supplied 
by the remote device I/O module. 
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NAMES OF COMMUNICATIONS CHANNELS 


The name of a communications channel is an encoding of the information 
describing the physical connection. Every such name is a string of 6 to 32 
characters. The name is divided into components separated by "." characters; 
each component represents a level of multiplexing. 


The first two components have a standard form, and describe a physical 
channel on an FNP. Multiplexed channels (i.e., subchannels of a concentrator 
whereby multiple terminals are supported on a single FNP channel) have additional 


components identifying the individual subchannels. The form of each component — 


depends on the type of multiplexer involved. 


The general form of the name of a physical channel is: 


F.ANSS 
where: 

EF 
is a top-level multiplexer name. If this is an FNP, the name must be 
a, b, ec, d, e€, f, g, or h. Other system or user defined top-level 
multiplexers may have different naming conventions. 

A | 
is 1 for a channel of a low-speed line adapter (LSLA) or h for a 
channel of a high-speed line adapter (HSLA). 

N 
is the number of the LSLA or HSLA on the specified FNP. It is in the 
range 0 to 5 for LSLAs or 0 to 2 for HSLAs. 

55 


Sa 
LSLA or HSLA. 


A channel called F.c000, where F is an FNP identifier, is a special virtual 
channel used by COLTS (Communications Online Test and Diagnostics System). It 
does not correspond to an actual physical channel on the FNP. 


< 


Examples 
a.1003 FNP a, LSLA 0, subchannel 03 
a.h219 FNP a, HSLA 2, subchannel 19 
e.1411 FNP c, LSLA 4, subchannel 11 
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In the following examples, the physical channel b.h108 (i.e., FNP b, HSLA!1, 
subchannel 8) is assumed to be a concentrator whose subchannels are numbered 
sequentially from 0 to 15: 


b.-h108.00 subchannel 0 (first subchannel) 
b.h108.03 subchannel 3 
b.h108.15 subchannel 15 (last subchannel) 
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PRINTER MODES AND CONTROL ORDERS 


The following are descriptions of the control operation and modes operation 
for the standard printer output module as supported by the remote teleprinter 
and remote printer I/O modules described in Section 6. 7 


MODES 


There are two mode types: binary and numerical. There is also a pseudo-mode, 
default, which sets all modes to their default values. A modes string is a 
string of mode keys separated by commas. The current value of a mode is changed 
when its mode key appears in the mode string. It is unchanged if the mode key 
is omitted from the mode string. Mode keys may appear in any order and if a key 
appears more than once, the last value is used. 


Binary Modes 


Each binary mode has two possible values. The mode is set if the mode key 
appears in the mode string. It is reset if the mode key begins with the "*" 
character. The binary mode keys are defined as follows: 


Ipg, tpg 
causes the output module to return to the caller when the end of the 
current page is reached (i.e., at the formfeed position for the next 
logical page). If there are unprocessed characters at this point, the 
code error table $request pending is returned. The default is “1pg. 


etl char, “etl char 

™~ causes the output module to pass nonprinting characters to the device 
as is. Carriage movement characters (newline, formfeed, carriage return, 
backspace, and horizontal and vertical tab) are interpreted normally. 
The ASCII escape character (octal 033) is also transmitted directly, 
unless esc mode is enabled (see below). If ctl char mode is disabled, 
the treatment of nonprinting characters is determined by the setting 
of non edited mode. The default is “ctl char. 


esc, “esc 
enables searching for escape sequences in the input string, which enables 
Slew to channel orders. The default is “esc. 


non edited, “non edited 
~ causes the output module to print the applicable octal ASCII code 
preceded by a backslash (\) for nonprinting characters, and to use the 
nonedited output conversion table in the specified TTT for the remote 
device. The “non edited value causes any such characters to be omitted 
from the output. The setting of this mode is ignored when ctl char is 
in effect. The default is “non edited. ~ 
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noskip, “noskip 
Suppresses the automatic insertion of blank lines at the end of a 
logical page (i.e., it allows the printer to print over the perforations). 
It has the side effect of setting the logical page length to its 
default value. The default is “noskip. 


print, “print 
specifies that processed characters from the input string are to be 
printed. The “print value allows a string to be processed for output, 
sets page and line counts, and honors the ipg and stopN modes, but 
without actually printing the processed characters. The default is 
print. 

Single, “single 
specifies that any formfeed or vertical tab characters from the input 
String are to be converted to newline characters (i.e., it suppresses 
runaway paper feeding). The default is “single. 


truneate, “truncate 
truncates the output if the line exceeds the line length. The “truncate 
vaiue allows the line to be wrapped onto the next line if it is too 
long. The default is “truncate. 


Numerical Modes 


Numerical modes supply a value to be used during a put chars operation. If 


the numerical portion of the mode cannot be converted to a binary number, a 
conversion error is sSignalled. The. default values for numerical modes are set 
by the default pseudo-mode or by the reset control operation (see below). The 
numerical modes are defined as follows: 
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p1lN 
sets the logical page length to N lines. At the end of a logical 
page, the printer skips to the next formfeed position (unless noskip 
mode is set). The value of N must be greater than one, and can be 
greater than a physical page. The default value is physical page 
length minus lines per inch. 

11N 
sets the logical line length to N characters. The value of N must be 
greater than the indentation (see below) and must not be greater than 
the physical line length of the device. The default value is the 
physical line length. 

inN 
sets the indentation to N characters. The value of N must be 0 or a 
positive integer which is less than the logical line length. The 
default value!tis!0. 

stopN 


sets the output module to return to the caller every N pages even 
though the processing of the input string has not been completed. If 
there is unprocessed input remaining, a code of 
error table $request pending is returned. A value of O means do not 
return until all input is processed. The counter of how many pages to 
process before returning is reset when a new value is given. The 
default value is 0. 
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CONTROL ORDERS 


The control orders for the printer output module sometimes take an info 


pointer argument. Each of these is identified in the following descriptions. 
Each info pointer describes a structure which contains additional data or provides 
a place for data to be written. All structures used for control orders are 
contained in the prt order info.inel.pl1 inelude file. The control orders are 
defined as follows: ~— = 


7/82 


channel stops 

sets the channel stop data used for slew to channel control sequences 
during a put chars operation. The info pointer defines the channel stops 
input array as found in the prt order info include file. Array element 
N defines the stops for line number N. Bit M of an array element 
defines a stop for channel M. The initial value is no stops defined. 
Once defined, the stops remain in effect until the next channel stops 
control operation. > 


end of page 
~ advances the paper to the bottom of the current page, one line below 
the point where page labels are printed. If page labels are set the 
label is printed. The info pointer is not used and may be null. 


get count 
~ returns accounting information. The info pointer defines the counts 
output structure as found in the prt order info include file. The 
page and line counts are reset by the reset control operation. 


get error count 
“~ returns the error count since the output module was attached. The 
info pointer defines the output variable ret error count as found in 
the prt order info include file. i a 


get position 

~ returns the position data defined by the position data structure in 
the prt order info include file. The data resembles that of the get count 
control operation, but the structure adds the total characters printed 
since the last reset to allow the caller to start the next put chars 
operation at the following character when the module returns due to 
Ipg or stopN mode. The data structure is also used for the set position 
operation (see below). ~~ 


inside page 
advances the paper to the formfeed position of the next inside page. 
An inside page is a top page when the listing is folded correctly. 
Separator bars for the head sheet are printed over the perforations at 
the bottom of an inside page. The info pointer is not used and may be 
null. 


outside page 
advances the paper to the formfeed position of the next outside page. 
An outside page is a bottom page when the listing is folded correctly. 
The info pointer is not used and may be null. 


page labels 
“sets the top and bottom page labels to be printed for each logical 
page. The info pointer may be null to reset page labels to blank. 
Otherwise, the info pointer defines the page labels input structure as 
found in the prt_order info include file. > 
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paper info 

sets the physical characteristics of the paper in the printer. The 
info pointer defines the paper info input structure as found in the 
prt order info include file. Once set, the paper info remains in effect 
until thé next paper info control operation. If the printer has a 
software loadable VFC image, a new image is loaded and the printer 
placed out of synchronization for the operator to align the paper. 
Otherwise, the code error table $no operation is returned so the caller 
can request the operator to load the appropriate VFU tape and set the 
required lines per inch switch to complete the operation. The defaults 
are: page length, 66; line length, 136; lines per inch, 6. 


reset 
resets the output module to its default state: default modes, no page 
labels, line count = 0, page count = 1, and total chars = 0. The info 
pointer is not used and may be null. 


resetwrite . 
cancels any data buffered for output. It is used to clear the output 
module after an error so the paper can be resynchronized. MThe info 


pointer is not used and may be null. 


runout 
causes all buffered data to be output before returning to the caller. 
It is used to synchronize the program with the actual device. The 


info pointer is not used and may be null. 


set position 
~ sets the internal counters in the output module. The info pointer 
defines the position data input structure as found in the prt order info 
include file. This fs the reverse of the get position control operation. 
It is used to start the accounting data at the correct point when 
restarting an I/O daemon request in the middle. 
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ptt 
see print terminal types command 
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tty modes (cont) 
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